Doc categories can now build their sidebar index directly in the admin UI. The index editor is an upcoming change for the Doc Categories plugin, and it removes the need to maintain a separate index topic.
Three ways to source an index
Editing a category now has a Doc index tab with a mode selector:
- Editor builds the index in place, as sections holding links.
- Index topic is the existing behaviour, where a topic’s headings and lists become the index.
- Disabled turns the sidebar index off for that category.
Categories already pointing at an index topic keep working exactly as they do today.
Building an index
A section holds links, and a link points either at a topic or at any URL you type. Each link can carry its own icon, and the editor warns you when two links resolve to the same place or two sections share a title.
You are also shown when topics in the category do not appear in the index, and you can add these topics in bulk:
An Auto-index section fills itself from the category’s topics, so you can list the pages you care about by hand and let everything else collect in one place. It can resync on each save.
Sections and links reorder by dragging. Every drag handle is also an ordinary tab stop that opens a move menu, so the whole index can be rearranged from the keyboard. A batch mode handles multi-select, for deleting several rows at once or dragging a whole selection together.
Enable it on your site
The index editor is an experimental upcoming change. Enable Doc categories index editor at /admin/config/upcoming-changes. It affects doc categories only, and only what admins see while editing one.
We’d love your feedback
Tell us how it holds up against a real index: whether building one here beats maintaining a topic, what is missing before you would move a category over, and anything that feels rough.