We are working on a new structure of the user documentation. More built up instead of alphabetical. "Cumulative" in tech-writing jargon. Starting with the base, gradually adding more advanced topics. In order to achieve that we will divide the whole user manual in different main subjects:

  • Content Management: given you have a Joomla site and have administrator rights, how do you manage articles, categories, menus etc. In this role you don't have to know anything about setting up a Joomla site, or about updating extensions.
  • Site Maintenance: to keep the software of an existing site up-to-date, you have to update Joomla and extensions, make backups (and know how to restore the site), manage users, check site health.
  • Site building: how to set up a Joomla site. This will probably be the biggest part, including user groups, ACL, Custom Fields, templates and overrides, configuration, editors, dashboards etc.
  • Testing: using the PatchTester. Maybe this should get its own place instead of being part of the user manual. It is more part of contributions to Joomla itself, like contributions to the documentation are or adding features or solving bugs.