Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
izmeez opened this issue Jun 18, 2024 · 2 comments
Open

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

izmeez opened this issue Jun 18, 2024 · 2 comments

Comments

@izmeez
Copy link

izmeez commented Jun 18, 2024

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
Copy link
Author

izmeez commented Jun 18, 2024

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

@izmeez
Copy link
Author

izmeez commented Jun 18, 2024

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant