Skip to content

sidebar_menu_truncate needs to be documented #979

@gary-vertica

Description

@gary-vertica

I just spent a day tearing my hair out trying to determine why some pages were being excluded from the section menu of our documentation. While looking into another issue I'm having with Docsy, I stumbled across a mention of the sidebar_menu_truncate param in PR #475. Sure enough, when I set this parameter to higher than the default value of 50, the missing pages appeared in the section menu.

I can't find any reference to this parameter in the distributed config.toml file, nor is it mentioned in the documentation. I can't understand why this parameter exists in the first place. It isn't intuitive to arbitrarily start excluding pages of documentation from the primary navigation menu when there are more than 50 pages in a section. But at the very least it needs to be either in the default config.toml or mentioned in the documentation. Preferably both.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions