Could I use an external link here? And use _blank for open new tab?
You can start with an optional brief description of the category.
## Test external
* Google: https://google.com
## First section
* https://discourse.example.com/t/topic-title/12
* https://discourse.example.com/t/another-topic-title/34
* Short title: https://discourse.example.com/t/topic-with-a-long-title/56
* Another title: https://discourse.example.com/t/another-topic-with-a-long-title/78
## Second section
* Topic title: https://discourse.example.com/t/documentation-topic/98
* https://discourse.example.com/t/new-topic/76
Opening this file will give important version compat notes. Others may have it within the description. Ie Category Moderators enhance plugin has disclaimer of only supporting stable branch.
Pavilion gives recommended discourse update frequency to ensure they have time to update their add-ons.
Does this work for subcategories? I have a site with 6 core categories but want documentation for each category, as well as discussion. Not quite sure how best to achieve this.
Just came across this and have a couple of questions please: How can we install it on our cloud-hosted site? And how much longer will the old Docs be around, do you think?
We donāt have a timeline for completely removing the old plugin just yet, but it is no longer being actively developed. Once we have made some decisions about this, weāll post an announcement about it to let everyone know!
Since this plugin is still experimental, it isnāt available on our hosting, but weāre currently discussing this internally and seeing if we can make this plugin available. Weāll circle back here once we have come to a conclusion there.
Iām gonna just add this for others who may find it confusing, like I was, what the plugin really does.
With all the settings, and the index topic, etc, it can feel overwhelming, on top of trying to understand what can be done, how it can be used, etc. At least, I was a bit confused until I figured out a way to understand it (if Iām missing something here, feel free to share it).
So basically the way I see it is: create your categories the way you want them and then this plugin just removes the default sidebar (with the sections for categories, tags, etc), and replaces it with a list of sections and links inside those sections to topics, categories, external links, etc. Itās just easier for me to look at it that way. Itās something more focused on customizing the sidebar when a particular category is visited. Something like: when category A is visited, replace the default sidebar with that custom sidebar provided by the index topic. Simple.
There isnāt too many options, or I would say there isnāt any options at all. Mobiles just donāt have enough space.
That is one reason why Iām considering leaving docs totally. Of my users aroung 95% are using mobiles, and they use sidebar very rarely or not at all. So curating doc-menu is quite time consuming and I donāt think that time/benefit ratio is in balance
Alright, Iāve read through this whole discussion and I have a few questions. I get that this pageās structure is created by this page, but then you also need an index page for each sub-category as well? The index for this page, must be enormousā¦ or any of the other ones with a ton of articles.
How hard would it be to implement an xwiki style of layout for pages that are part of a Discourse siteās documentation. The UI is simple enough, you check the box on page creation stating that this page is documentation. Now it simply asks you what the parent is. No parent? Itās a top level subject. You set a parent, the page shows up under that subject/category. This completely eliminates the requirement to manually maintain index pages. They look like a lot of extra work that shouldnāt be necessary. And easy to overlook adding things as theyāre created.
If you go to https://checkin.technospider.com and disclose some of the items in the sidebar, you can see how the nesting works in a real world example. That entire sidebar is dynamically generated simply by nesting pages under other pages (parent/child relationship). This site only has about 150 pages on it but it would have taken me twice as long to get it completed if I had to make indexes to create all of that.
And that brings me to a UI/UX issue with how the Docs sidebar is laid out. Once you click away from the main page, you lose the initial list of categories. You should have a way to go back on the page somewhere.
Each of your 8 main areas should have disclosure triangles on them so whether you click the box on the main page, or the name in the sidebar, it just drops down and you donāt lose the ability to directly click on another of the main areas.
You have a breadcrumb on each end article, but even that is missing from the 8 categories. Clicking āremove filterā from the subcategories at the top of the page takes me back, but thatās very unintuitive. And you can do some weird things by playing with the filters, for example, the nice green banner disappears if you click āno subcategoriesā
Yes, thatās for site management topics, the index page is here. (index is a tag that reveals all the index pages)
Agree it mustāve taken a good bit of work to corral all the page links and put them nicely in categories with labels. But the result is so darn nice and usable!
It definitely looks nice, but as I stated, thereās some usability issues as far as navigation is concerned.
And if the work can be eliminated that seems like a win for everyone.
Iām not dogging on the work done, it looks very nice and since I canāt code to save my life I canāt even begin to appreciate how much work went into it, or how much more work my suggestions would be.
Itās good for minimum docs, but a lot of markup is missing that I used on the wiki I linked to. Unless Iām just missing it. Iām still pretty new to Discourse.
For example, I canāt find a way to make info/warning/error boxes.
