Update (4 June 2024): The initial work of restructuring documentation topics has been completed, and the new categories are now live with new indexes showing what you will find in them. You can check them out here: Documentation - Discourse Meta - if you notice anything looking incorrect, please post below!
After a thorough review of our current documentation structure, we’re happy to share that we are in the process of improving the categorisation of our documentation to make the topics more organised and focused on the goals our community is aiming to achieve. Our goal is to enhance the clarity and usability of our documentation, making it easier for everyone to find the information they need.
What to Expect
New Categories
Going forward, our documentation will be categorised and tagged based on the action or functionality it describes. The current groupings based on user role will fall away, and we will update all documentation topics to indicate which user role is required to perform the activities it describes.
Temporary Visual Changes
During this restructuring, you might notice some sections of our documentation looking a bit out of place or disorganised. Don’t worry! This is only temporary as we work to finalise the new structure.
Comprehensive Updates
Once the restructuring is complete, our next step will be to update all documentation topics to align with a new, common style guide. We will also be correcting any inaccuracies that may exist. This will be an ongoing project, with the bulk of the work being done over the next few weeks.
How You Can Help
Your feedback, as always, is invaluable to us. If you come across any issues or have suggestions on how we can further improve our documentation, please don’t hesitate to share your thoughts in site feedback or as a post on this topic.
Thanks for bearing with us as we make these changes!
For now, I’ve added the new categories into the mix. 