New help system for core (!!) needs your help!

We encourage users to post events happening in the community to the community events group on https://www.drupal.org.
jhodgdon's picture

I'm very pleased to announce that we (hopefully) have a new help system in Core that will actually serve the needs of module, theme, and distribution developers! It is called "Help Topics", and is currently in "Experimental Module" status in Drupal core 8.8.x.

The way it works:

  • Modules, themes, and distributions can have a help_topics subdirectory in their projects, where they can write help topics in the form of Twig template files. Each project can have as many topics as they want/need to document their project.
  • The Twig files have meta-data (in HTML meta tags) at the top to define the title of the topic, whether the topic is "top-level" or not, and a list of other topics to mark as "related".
  • When a user visits the admin/help page (assuming the Help and Help Topics modules are enabled), they will see a list of the top-level topics, and can click through to read them. When reading a topic, at the end they'll see a list of all the topics that are "related" (and "related" is automatically a bi-directional relationship).

So... The module is currently in "Experimental" status, and we need your help to get it to "Beta" and then "Stable" status in Drupal Core:

This effort is being led by andypost, Amber Himes Matz, and jhodgdon... if you have questions, we can all often be found on Slack or on drupal.org.

Comments

Drupal Slack channels to get in touch

Amber Himes Matz's picture

If you have a question about Help Topics and want to get in touch in Drupal Slack (https://www.drupal.org/slack), #documentation and #contribute channels are your best bets.

My Slack username is ambermatz (jhodgdon's and andypost's are the same as their d.o. usernames).

As a best practice, if you have a Slack conversation about a Help Topics issue, after your chat, please go to the issue you were discussing and leave a comment summarizing your conversation/decision/feedback.

Thank you!

Amber Matz

Slack docs channel not documented (until now)

colan's picture

This would certainly explain why I never received a response on IRC in #drupal-docs...

The documentation discussion has moved to Slack without that being documented. I've now documented this at:

Thanks!

jhodgdon's picture

Yeah, sorry about that! The whole Drupal contribution community has pretty much moved from IRC to Slack, without much posting about it. Thanks for updating the documentation!

Amazing news! Thanks for the summary

Balu Ertl's picture

That's amazing news! Thanks for briefly summarizing the very long comment thread of this Add experimental module for Help Topics issue. Hope I can find some time to prepare our GDPR module's docs in this way...

This is great, and it seems

PQ's picture

This is great, and it seems like a logical next step from there would be power some if not all of the module documentation pages on drupal.org from this so that developers only have to manage it in one place. This would also mean that document would automatically be versioned by module version, so flipping between the 2.x and 3.x versions of the docs on d.o should be relatively simple to set up.

Interesting idea!

jhodgdon's picture

I'll make an issue so we can discuss that... let's see. Here's the issue:

https://www.drupal.org/project/drupalorg/issues/3066332

Documentation

Group categories

Event type

Post type

Group notifications

This group offers an RSS feed. Or subscribe to these personalized, sitewide feeds:

Hot content this week