Allow users to filter content by some sort of tagging we can apply to the docs.
i'd like to see a system where i can by some menu set what i'm trying to use (explorer, apiml, desktop, etc) and what i have (racf, top secret, acf2, etc) and all of the doc that is 100% irrelevant to those tags will disappear so the user can see a small and organized set of docs
So, my idea is that the user chooses in some menu what type of install they want and what dependencies they have, and what optional features they want like SSO, HA, etc. Then the sections of doc that dont have the same tags as the chosen options are either removed from the page with react disabling the HTML sections, or making the text grey-out with react adjusting the CSS. This way users can still read the documentation in the same layout as today, but they will not be bothered by irrelevant sections that if they accidentally read would confuse them and maybe cause them to install things they didnt need
Information that might be useful for this work (by Arijit @covalentbond )
we are using Docusaurus as the site generator. It's built on top of ReactJS.
Docusaurus by default gives us a template of all set of components - you can find on the site. Though it also gives us the option to customize any component accordingly, which can be useful here.
Here are the default components used by the Docusaurus theme. We tweaked the DocItem component to include Doc Sharing, PDF & other option like Ratings.
DocItem is the main Doc component in which the doc is being shown. You can find it in the src/theme directory.
For tagging purposes, I think we can add tags in the Frontmatter of every markdown file of doc. I'm not having a clear idea of the functionality needed & the implementation.
But we can do anything in the site, what we can do with ReactJS.
Proposal from Sean @1000TurquoisePogs :
Information that might be useful for this work (by Arijit @covalentbond )