>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #2762837. --> Reported by: [tvn](https://www.drupal.org/user/999848) >>> <p>As a part of <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/drupalorg/-/work_items/2533684" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/drupalorg/-/work_items/2533684</a></span> we are getting ready to migrate existing documentation into the new section.</p> <p>During the migration:</p> <ul> <li>the content type for documentation will be changed from 'book page' to 'documentation page' and 'documentation guide'</li> <li>documentation will be split by major Drupal version (<span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/documentation/-/work_items/2587331" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/documentation/-/work_items/2587331</a></span>)</li> <li>documentation will be reorganized into a new structure (<span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/documentation/-/work_items/2744915" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/documentation/-/work_items/2744915</a></span>)</li> <li>book outline will be replaced with 'guides' system, where guide is a collection of documentation pages with own menu and maintainer(s), who have additional permissions to take care of the content inside of the guide</li> </ul> <p>We will start by migrating 'generic' documentation, such as Understanding Drupal, Structure guide, etc. Documentation for contributed projects will follow in a couple of weeks.</p> <h3>Progress:</h3> <ul> <li><a href="https://www.drupal.org/node/3522465">Orphaned pages</a> </li><li><del>Understanding Drupal</del></li> <li><del>Installation Guide</del></li> <li><del>Administration &amp; Security Guide</del></li> <li><del>Structure Guide</del></li> <li><del>Multilingual Guide</del></li> <li><del>Mobile Guide</del></li> <li><del>Theming Guide</del></li> <li><del>Develop for Drupal</del></li> <li><del><a href="https://www.drupal.org/documentation/build">Site Building Guide</a>: <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/documentation/issues/3443035" title="Status: Closed (fixed)">#3443035: Review and migrate 'Site Building Guide' book</a></span></del></li> <li><del><a href="https://www.drupal.org/to-be-migrated">To be migrated</a></del>: <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-3"><a href="https://www.drupal.org/project/documentation/issues/2832228" title="Status: Closed (duplicate)">#2832228: Review and migrate 'To be migrated' book</a></span></li> <li><del><a href="https://www.drupal.org/migration-archive">Migration archive</a>: may be pages already decided to delete.</del> <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/documentation/issues/3515539" title="Status: Closed (fixed)">#3515539: Identify Migration archive page for delete or needs migration</a></span></li> <li><del><a href="https://www.drupal.org/documentation/reference">Reference</a></del>: <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/documentation/issues/3457287" title="Status: Closed (fixed)">#3457287: Decide what to do with 'Reference/Snippets'</a></span> &amp; <span class="drupalorg-gitlab-issue-link project-issue-status-info project-issue-status-7"><a href="https://www.drupal.org/project/documentation/issues/3457288" title="Status: Closed (fixed)">#3457288: Decide what to do with 'Reference/Troubleshooting'</a></span></li> <li><del>Tutorials and site recipes</del></li> </ul> <h3>How to help</h3> <p>If you'd like to help during and after migration, sign up to maintain specific part of the documentation over at <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/documentation/-/work_items/2682083" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/documentation/-/work_items/2682083</a></span></p> <h3>Information for contributed project maintainers</h3> <p>If documentation for your project exists somewhere in Site Building Guide or any other documentation book, we will create a new documentation guide, and migrate existing docs into it. If you are project maintainer, you will be added as a guide maintainer, so that you could modify guide, its menu, its contents, add other guide maintainers, etc.</p> <p>Please be prepared to spend a bit of time in the next few weeks modifying your documentation post-migration. If there is specific time before/after which you want us to migrate documentation for your project, please let us know in the comments.</p> <p><strong>NOTE: Existing order of pages set via Book outline will be lost during migration. You will have to rearrange menu of your new documentation guide to set desired order of the pages.</strong></p> <p>The hierarchy of the pages inside of the guide is flat, which means there are no 'child' pages, all of them are on the same level inside of the guide. We strongly encourage you to merge pages together to create guides with fewer, longer, pages.</p> > Related issue: [Issue #2817225](https://www.drupal.org/node/2817225) > Related issue: [Issue #3453924](https://www.drupal.org/node/3453924)