>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #1549580. --> Reported by: [jhodgdon](https://www.drupal.org/user/155601) >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>Drupal currently lacks a system for writing really good technical documentation. We should have one, and in particular, the Drupal Documentation Team needs such a system for two purposes.:<br> a) In-line Help (what the core Help and contributed Advanced Help, and possibly other modules provide within a Drupal site)<br> b) Official/Curated Documentation (a controlled set of really good documentation about how to use Drupal to build sites).</p> <p>We have had previous discussions of these two systems on issues:<br> <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/documentation/-/work_items/1291058" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/documentation/-/work_items/1291058</a></span><br> <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/drupal/issues/1031972" title="Status: Closed (fixed)">#1031972: Discussion: What would a better help system for D8 be?</a></span><br> as well as on various groups.drupal.org posts in the <a href="http://groups.drupal.org/documentation-team">Documentation Team area</a>. We came to the conclusion that they should be the same system. This issue is for tracking progress in actually building the system we need.</p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>Build a really good technical documentation system. The full specifications for the proposed system are on the <a href="http://drupal.org/node/1095012">Help and Curated Documentation System</a> page.</p> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <p>See the full plan at <a href="http://drupal.org/node/1095012">http://drupal.org/node/1095012</a> for details of these tasks.</p> <p>Phase 1: Curated/Official Docs System<br> - Conditional Text module - DONE - <a href="http://drupal.org/project/conditional_text">http://drupal.org/project/conditional_text</a> - may need some updates?<br> - Help Entities module and Map entity - Sandbox project: <a href="http://drupal.org/sandbox/temaruk/1604964">http://drupal.org/sandbox/temaruk/1604964</a> - needs some updates<br> - Workflow module for editing/translating permissions - see issue <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/documentation/-/work_items/1283496" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/documentation/-/work_items/1283496</a></span> as well as the system specs.<br> - Set up a site (drupal.org or help.drupal.org?), test, and deploy.</p> <p>Phase 2: Refinements<br> - Better UI for creating Maps<br> - Revisions workflow<br> - Glossary</p> <p>Phase 3: Inline help<br> - Help importer/updater client/server</p>