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:

  • Joomla Elements: Describe the fundamental elements on which a Joomla! site is built. It is important to understand how these work together to create and render content.
    • Templates
    • Components
    • Modules
    • Plugins
  • 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.
    • Overview: describe what content management means and how each element contributes to it.
    • Templates: describe what a template does and how the site is built upon it.
      • Positions
      • Styling
    • Articles: explain how to create an article, edit it, save it, and publish it.
      • Creating
      • Editing
      • Publishing
    • Categories: explain how article categories can be beneficial.
      • Benefits
      • Usage
    • Modules: explain how modules are a type of content to include in articles and template positions.
    • Plugins: explain how plugins differ from modules and their benefits.
    • Tags: describe how to create tags and use them in both the site Frontend and Backend.
    • Media: explain how to upload and manage media, such as images, videos, and other files.
    • Menus and Menu Items: explain the basis for menus and how to use them to access your site pages.
      • Creating
      • Types of Menu Items
  • 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.