8000 Ignore function's main description · Issue #444 · mkdocstrings/mkdocstrings · GitHub
[go: up one dir, main page]

Skip to content
Ignore function's main description #444
@artperrin

Description

@artperrin

Hi,
First thing : mkdocstrings is awesome.

That being said, I'd like to hide the function's description when using the ::: app.function syntax.
For example, if I have this function in an app.py file:

def mkdocstrings_is_awesome(fish: str, percolator: set) -> bool:
    """But I'd be better if I could hide this description!

    Args:
        fish (str): a fish.
        percolator (set): this thing in a coffee machine.

    Returns:
        bool: whether there is a fish in the percolator.
    """
    return fish in percolator

and the mkdocstrings plugin called in my mkdocs.yml, the ::: app.mkdocstrings_is_awesome line renders this first screenshot.

sc1

I'd like an option like ignore_description to be able to render the second screenshot.

::: app.mkdocstrings_is_awesome
    options:
        ignore_description: true

sc2

And that's about it. Thanks again for this plugin! 😄

Metadata

Metadata

Assignees

No one assigned

    Labels

    featureNew feature or request

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions

      0