backdrop-ops / docs.backdropcms.org

Website for displaying Backdrop CMS documentation and API source code.
https://docs.backdropcms.org/
6 stars 6 forks source link

Need to expand User Guide and add "Site builder guide" like Drupal #234

Open izmeez opened 2 months ago

izmeez commented 2 months ago

First a quick thought to come back to:

Previous discussions in zulip shed light on the usefulness of docs on drupal pages that have been created by human contributions for decades, on subjects like databases, and are at risk of being lost, to be deleted, and replaced by some automated isimulator.

  1. Preservation of drupal doc pages by human contributors over decades.

Through immediate action the database doc pages were copied into the Backdrop CMS docs, just in case.

For this issue, Here is an image of the current backdrop docs,

backdrop-user-guide-screenshot-2024 06 18

The section on contributed modules seems to be more from a developers perspective. What is missing is something like found in the Drupal Site Building Guide, a section called Contrib modules for building the site functionality. There are many headings of a functional nature that each contain child pages on specific contrib modules., pages with additional information, comments, suggestions and experience.

drupal-contrib-to-build-functionality-screenshot-www drupal org-2024 06 18

It may not be a surprise that much of this information is applicable to Backdrop and might be worthy of mention.

In zulip chat it was suggested the information on specific modules may be links to the project page or readme and if a wiki exists to the wiki. It might also include an automated reminder to the module maintainer to open a wiki whenever someone visits the wiki link to see what's there.

There is also the need for discussions that overlap related modules and how they can be integrated as some of the drupal pages demonstrate.

izmeez commented 2 months ago

The functionality title pages may be simple like some of the drupal pages, https://www.drupal.org/node/206728

izmeez commented 2 months ago

Could this be built as a taxonomy with term pages as the anchor with module links to where the term is used?