Drupal Documentation Review: Merging CMS and User Guides Under Discussion

Venn Diagram oof Drupal and CMS

Joe Shindelar of Drupalize.Me outlined ongoing discussions about the future of Drupal documentation, specifically whether the Drupal CMS Guide and the Drupal User Guide should be combined. The Drupal CMS Guide was created quickly as an MVP and differs from the User Guide by incorporating contributed modules alongside core Drupal features. While the User Guide is structured, translatable, and follows an editorial workflow, it focuses only on Drupal core. Joe highlighted concerns about maintaining two separate but overlapping guides, the impact on users navigating between them, and the challenges of translation and updates. He leans toward merging the guides, prioritizing Drupal CMS for new users while noting that differences for core users could be addressed within a unified resource. The discussion remains open, with feedback encouraged from the community.

Source Reference

Date of Publication
Organization

Disclosure: This content is produced with the assistance of AI.

Disclaimer: The opinions expressed in this story do not necessarily represent that of TheDropTimes. We regularly share third-party blog posts that feature Drupal in good faith. TDT recommends Reader's discretion while consuming such content, as the veracity/authenticity of the story depends on the blogger and their motives. 

Note: The vision of this web portal is to help promote news and stories around the Drupal community and promote and celebrate the people and organizations in the community. We strive to create and distribute our content based on these content policy. If you see any omission/variation on this please reach out to us at #thedroptimes channel on Drupal Slack and we will try to address the issue as best we can.

Related Organizations

Upcoming Events

Latest Opportunities