Create 'Documentation' Section
>>> [!note] Migrated issue
<!-- Drupal.org comment -->
<!-- Migrated from issue #2533684. -->
Reported by: [tvn](https://www.drupal.org/user/999848)
>>>
<h2>Overview</h2>
<p>‘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.</p>
<p>More details on what is changing about documentation:<br>
<a href="https://docs.google.com/presentation/d/13CDspZ1UAQ2VreExy8Z-GCSDUvi_IK-NIXBzReUlRP0/edit">DC NOLA session slides</a><br>
<a href="https://www.youtube.com/watch?v=sIsuh8ckrtc">DC NOLA session video</a></p>
<h2>Personas</h2>
<p>The Section is focused on Skilled and Expert users, who consume documentation (Readers) and contribute to it (Editors and Maintainers).</p>
<h2>Scenarios</h2>
<p><a href="https://docs.google.com/spreadsheets/d/1X1Rnhr0uJ5z3vRHsgK3jfeceuIeNdVXKsD5X1RoOZO8/edit#gid=1549072072">List of user scenarios</a><br>
<a href="https://docs.google.com/drawings/d/1gKZPdOSg3mYH9D-AUAueS6ziw-Ub11XPm5100Mr-19s/edit">Story map of the scenarios</a></p>
<h2>Background</h2>
<p>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.</p>
<p><strong>Working group:</strong><br>
Building ‘Documentation’ Section and related documentation tool improvements supports 'Manage' and 'Use' groups of goals identified by <a href="https://www.drupal.org/governance/docwg-goals">Documentation Working Group</a>, as well as covers all of their 2015 priorities.</p>
<p><strong>Drupal Association:</strong><br>
Building ‘Documentation’ Section and improving documentation tools directly supports the two goals of the Drupal Association:</p>
<ul>
<li>to enable the focused, effective, efficient development of Drupal,</li>
<li>to develop sufficient professionals to meet global demand for Drupal.</li>
</ul>
<p>Additionally it indirectly positively affects the following goals:</p>
<ul>
<li>to ensure the sustainability of the project and community by creating more Experts and Masters who develop Drupal the software and contributed modules</li>
<li>to increase Drupal adoption for customers with complex and changing needs including global markets.</li>
</ul>
<h2>User engagement and contribution</h2>
<p>The types of user engagement and contributions we'll be able to (better) capture and display on user profiles:<br>
- documentation edits (purely documentation, right now there is a lot of content created using book page content type, which is not documentation)<br>
- documentation sections maintained<br>
- documentation maintainers</p>
<h2>Implementation details</h2>
<ul>
<li>‘Documentation’ is a top level Section of the site.</li>
<li>Present in top navigation.</li>
<li>It is an organic group.</li>
<li>Includes sub-groups (per sub-section of documentation)</li>
<li>Types of content created in this Section: documentation.</li>
<li>Types of content displayed in this Section from elsewhere: none.</li>
<li>URL: drupal.org/documentation</li>
<li>
</ul>
<h3>In progress:</h3>
<p><span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/drupalorg/-/work_items/2218551" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/drupalorg/-/work_items/2218551</a></span><br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/documentation/issues/2574783" title="Status: Closed (fixed)">#2574783: Content Audit for documentation on Drupal.org</a></span><br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/documentation/issues/2744915" title="Status: Closed (fixed)">#2744915: Define new structure for documentation</a></span><br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/documentation/issues/2762837" title="Status: Closed (fixed)">#2762837: [Meta] Migrate documentation into the new system</a></span></p>
<h3>Next steps:</h3>
<p><span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/drupalorg/issues/2679643" title="Status: Closed (fixed)">#2679643: Connect projects to documentation guides</a></span></p>
<h3>Done:</h3>
<p>Usability testing for upcoming changes<br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/drupalorg/issues/2578695" title="Status: Closed (fixed)">#2578695: Use CKEditor on *.drupal.org sites</a></span><br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/drupalorg/issues/2682073" title="Status: Closed (fixed)">#2682073: Update documentation statuses and their display</a></span><br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/drupalorg/issues/2679635" title="Status: Closed (fixed)">#2679635: Create group content type (guide) for documentation</a></span><br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/drupalorg/issues/2585027" title="Status: Closed (fixed)">#2585027: Edits on documentation nodes should automatically generate comment</a></span><br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/documentation/issues/2587331" title="Status: Closed (fixed)">#2587331: Split documentation per Drupal version</a></span><br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/drupalorg/issues/2584965" title="Status: Closed (fixed)">#2584965: Display comments on a separate tab for documentation pages</a></span><br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/drupalorg/issues/2574901" title="Status: Closed (fixed)">#2574901: Survey book page visitors about their experience</a></span><br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/drupalorg/issues/2574927" title="Status: Closed (fixed)">#2574927: Setup Google Analytics tracking on book page</a></span><br>
<span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/drupalorg/-/work_items/1304216" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/drupalorg/-/work_items/1304216</a></span><br>
<span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/drupalorg/issues/2585059" title="Status: Closed (fixed)">#2585059: A user should be able to "follow" documentation pages</a></span></p>
> Related issue: [Issue #2481515](https://www.drupal.org/node/2481515)
issue