Create 'Documentation' Section

Overview

‘Documentation’ is a top level Section of Drupal.org. A central place for finding and reading Drupal documentation. It contains general documentation on Drupal, and has clear contextual paths to project-specific documentation and API documentation.

More details on what is changing about documentation:
DC NOLA session slides
DC NOLA session video

Personas

The Section is focused on Skilled and Expert users, who consume documentation (Readers) and contribute to it (Editors and Maintainers).

Scenarios

List of user scenarios
Story map of the scenarios

Background

Documentation is a crucial part of any software product. Documentation Section is designed to help move Drupal.org users from Skilled to Expert, by enabling them to successfully build, maintain, and improve Drupal sites and Drupal itself.

Working group:
Building ‘Documentation’ Section and related documentation tool improvements supports 'Manage' and 'Use' groups of goals identified by Documentation Working Group, as well as covers all of their 2015 priorities.

Drupal Association:
Building ‘Documentation’ Section and improving documentation tools directly supports the two goals of the Drupal Association:

• to enable the focused, effective, efficient development of Drupal,
• to develop sufficient professionals to meet global demand for Drupal.

Additionally it indirectly positively affects the following goals:

• to ensure the sustainability of the project and community by creating more Experts and Masters who develop Drupal the software and contributed modules
• to increase Drupal adoption for customers with complex and changing needs including global markets.

User engagement and contribution

The types of user engagement and contributions we'll be able to (better) capture and display on user profiles:
- documentation edits (purely documentation, right now there is a lot of content created using book page content type, which is not documentation)
- documentation sections maintained
- documentation maintainers

Implementation details

• ‘Documentation’ is a top level Section of the site.
• Present in top navigation.
• It is an organic group.
• Includes sub-groups (per sub-section of documentation)
• Types of content created in this Section: documentation.
• Types of content displayed in this Section from elsewhere: none.
• URL: drupal.org/documentation

In progress:

#2218551: A user should be able to "follow" a Section of content
#2574783: Content Audit for documentation on Drupal.org
#2744915: Define new structure for documentation
#2762837: [Meta] Migrate documentation into the new system

Next steps:

#2679643: Connect projects to documentation guides

Done:

Usability testing for upcoming changes
#2578695: Use CKEditor on *.drupal.org sites
#2682073: Update documentation statuses and their display
#2679635: Create group content type (guide) for documentation
#2585027: Edits on documentation nodes should automatically generate comment
#2587331: Split documentation per Drupal version
#2584965: Display comments on a separate tab for documentation pages
#2574901: Survey book page visitors about their experience
#2574927: Setup Google Analytics tracking on book page
#1304216: A user should be able to "follow" individual pages of content and receive email notifications for new comments
#2585059: A user should be able to "follow" documentation pages