Problem/Motivation

We got lots of requests to fix / update things in the docs. Because this is now managed docs, there is no direct edit button, so people come to Slack to ask. It takes lots of coordination there, and we can't track what it done or not done :)

Steps to reproduce

Proposed resolution

I think we should add a block to Drupal CMS (sponsored) docs pages like

"Found a problem on this page?"
"Submit a documentation issue" <= link to drupal_cms docs issue submission or search that has the submit button at the top :)

I don't know if this is best as a configured custom content block or a code provided block which is then placed, so not sure how to help :)

Remaining tasks

User interface changes

API changes

Data model changes

Issue fork drupalorg-3506170

Command icon Show commands

Start within a Git clone of the project using the version control instructions.

Or, if you do not have SSH keys set up on git.drupalcode.org:

Comments

gábor hojtsy created an issue. See original summary.

fjgarlin’s picture

We can create the block plugin here, like these two: https://git.drupalcode.org/project/drupalorg/-/tree/1.0.x/src/Plugin/Blo...

Then we'll worry about how to place it.

Right now we are in an interim situation where the content of the new site is managed by a small group of people, so probably the link should go to this issue queue and then we can triage and redirect from here.

drumm’s picture

We’ll want to port the “How to improve this page” block from documentation pages like https://www.drupal.org/docs/getting-started/system-requirements/web-serv...

First we should port it without functionality changes, so regular documentation pages will be set up correctly. Drupal CMS documentation is an exception, so after the basics are done, adjustments should be made. For example, there will not be general edit or commenting (discuss) access for these pages.

Some notes from when I’ve discussed this before:

The D7 version has Discuss, which is regular node comments moved to a separate local task page, which we'll want for regular documentation. For the CMS documentation section & pages, we'll want to make sure comments are off and this block has logic to detect that. We're somewhat building this backwards since the CMS documentation's special cases should be built on top of the base documentation functionality, which we should keep mostly as-is.

I hadn't looked into how this was done in D7 yet, that we might want to change. Its a View, with a field formatter for all the text https://git.drupalcode.org/project/drupalorg/-/blob/089409007720bc9009d6...
So changing the text based on logged in status, edit access, comment status, doesn't happen. We could put in some all-or-nothing checks with Views filters or block visibility rules, but anything with different versions of the text would get messy in Views.

The equivalent on D7, https://www.drupal.org/docs/user_guide/en/index.html is imported, looks like it has the block hidden when there's a field set that indicates it was imported. And there's a different block that shows in the footer.

I'm thinking it would be best to have this all in one block, so it gets placed once, consistently. We can get as far as possible with logic in custom code, that works for normal documentation pages. If we need something additionally special for the CMS guide, we can add logic to check for the page being in that guide.

b_man made their first commit to this issue’s fork.

fjgarlin changed the visibility of the branch 7.x-3.x to hidden.

  • fjgarlin committed 059f11c0 on 1.0.x authored by b_man
    Issue #3506170 by b_man, fjgarlin, drumm: Add "Submit issue about docs"...
fjgarlin’s picture

Status: Active » Fixed

Merged.

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.