Drupal Documentation Review: Merging CMS and User Guides Under Discussion
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.