Make it easier for guide maintainers to find un-listed pages & guides

Created on 9 October 2022, over 2 years ago
Updated 11 October 2023, over 1 year ago

Problem/Motivation

It was reported and fixed in #3035738: Adding a documentation guide to "Contributed modules" is totally dysfunctional that some "Contributed Modules" documentation guides remain unpublished too long, by configuring new Documentation Guides to get automatically approved and published.

New "Contributed Themes" guides are now published right away, whereas pages under https://www.drupal.org/docs/drupal-apis & https://www.drupal.org/docs/theming-drupal should be reviewed by someone. Those in particular are places where bad documentation could be harmful, such as leading to security issues.

Quite a few pages were also unreviewed for a long time, and not added to the menu, as can be seen by this search for the string "This page has not yet been reviewed by".

The status of pages can be seen under documentation dashboard , which is great. However, it would be nice to also see if the page is listed or not, maybe by adding an extra "In menu" column? (Yes/No)

Steps to reproduce

  1. Visit a page such as https://www.drupal.org/docs/theming-drupal/twig-in-drupal/using-custom-c...
  2. See that it was created February 2021
  3. See that it probably could get added to the menu, and that it's not

Proposed resolution

  • Check if some documentation sections have lingering pages, which can get added to the menu.
  • Add an extra "In menu" column (Yes/No) and filter in the documentation dashboard

Remaining tasks

  • Check documentation sections with lingering pages, and add to the menu where relevant
  • Add an extra "In menu" column (Yes/No) and filter in the documentation dashboard

User interface changes

API changes

Data model changes

📌 Task
Status

Active

Version

3.0

Component

Documentation

Created by

🇩🇰Denmark ressa Copenhagen

Live updates comments and jobs are added and updated live.
  • Needs issue summary update

    Issue summaries save everyone time if they are kept up-to-date. See Update issue summary task instructions.

Sign in to follow issues

Comments & Activities

Not all content is available!

It's likely this issue predates Contrib.social: some issue and comment data are missing.

Production build 0.71.5 2024