Allow category pages | Voters

Allow category pages

complete

Binary Logic

It would be nice if clicking a category could render a page. This could serve as the top-level overview page for that category. Perhaps allowing an optional

href

attribute on the category sidebar type would allow this?

November 3, 2019

Sébastien Lorber

marked this post as

complete

This is in canary and scheduled for a release next week

Sébastien Lorber

Merged in a post:

Option to make categories clickable links to docs as well (for overview, introduction articles)

Kristoffer Witt

In our documentation, we would like each category to have an introductory article specifying top level information and an overview of the articles contained within the category. This does not seem possible at the moment.

An idea would be to only navigate to this "category article" if you click the label, while clicking the expander arrow should

only

expand and

not

navigate to the "category article".

October 15, 2021

Sébastien Lorber

marked this post as

in progress

Margo Poundstone

Have received a request from users of our docs site for this feature as well.

Zack

It is much worse UX to have 2 or even 3 subcategories with which you end up having 2 or 3 TOC entries which are there only to categorize entries - and then clicking them doesn't render any content.
I also don't understand why you should have a category and then add a similar entry or a non-meaningful entry underneath which reads just Overview. If you have 10 categories, does this mean you should have 10 Overview pages under each?
Clicking on a category (parent) in the TOC should both expand and open the linked content page. Clicking on the arrow should only expand or collapse without opening the linked content page.

Beth

Yes! It makes our docs very awkward having to come up with an arbitrary extra page name for that first doc. We would prefer that clicking on the category renders the initial page.

Lu Nelson

I agree with this, it would be an intuitive way to represent hierarchical material, if the category link could also show a page, it would be the overview page of the category

Claire Carroll

We migrated from readme.io, where this was a feature, and we used it heavily! It was really nice to be able to nest related keywords under one overview article

Oliver Ullman

I'm also wishing for the same thing. Some people may not believe it is good ux, but ultimately that should be our call to make

Aver

I'm not so sure that's a good user experience. As an end user, it will not be obvious whether clicking on the category will take me to a doc or expand the category. Forcing the user to only rely on the arrow icon for expand/collapse is not a good ux in my opinion.

prasan kumar

Aver: Yes that's not a good user experience, within the each category - can have separate document called "About/ Intro".

→