>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #236444. --> Reported by: [holland1945](https://www.drupal.org/user/234719) >>> <p>The current Drupal documentation page has two major flaws: its hierarchy and the choice of information to present. Currently, the site is unclear, redundant, and intimidating. It is at once extremely general and overly detailed. </p> <p>Prime examples of this are:</p> <p>*"Projects and Features" is listed under the "Getting Started" section. Is this also not applicable to "About Drupal?"<br> *It is not immediately clear to new users what the difference between a tutorial, snippet, and HowTo is.</p> <p>It seems that with all of the constant influx of content, the Drupal community has a difficult time centralizing, proofing, and prioritizing contributions while maintaining the sponetaneity and openness of a community plumbing format. Thus, I think the Drupal community should consider a complete revamp of the documentation page. There are three parts to this.</p> <p>First, don't make the page handbook-centric. While it is a novel idea to quantify user submissions into such manageable units, it leaves the documentation page too decentalized and overwhelming to newcomers.</p> <p>Second, and most importantly, have an official, community-collaborated <strong>Fairly Exhaustive Drupal Guide</strong> for every major release. This should cover everything-- from background behind the project, to the technology stack, to an installation walkthrough, to an explanation of core modules and Drupal's taxonomy system, to theming, to hacking modules, etc. Essentially, centralize the documentation page by organizing all pertinent current contributions into one peer-edited coherent ebook. The closest two things I could find to this on the documentation page were:</p> <p><a href="http://drupal.org/getting-started/5">http://drupal.org/getting-started/5</a><br> <a href="http://drupal.org/handbook/customization/tutorials/beginners-cookbook">http://drupal.org/handbook/customization/tutorials/beginners-cookbook</a></p> <p>The first is already a big step towards such an exhaustive guide. Why not finish the job?</p> <p>The attached image is a rough mock-up of what such a documentation page could look like. </p> <p>And finally, make "About" a separate section on the Drupal webpage. "Documentation" is a hiedous word, and a huge turnoff to someone looking to quickly grasp what Drupal is.</p> <p>Regarding motivation and manpower: Google has a summer of code... there could be a <strong>Drupal Documentation Day</strong> where the community- and not just those working on documentation issues- takes a step back and lines up for a small topic to tackle. </p> <p>It is critical for those translating Drupal documentation to other languages to have an exhaustive, centralized, open document (that is prominently displayed on the documentation page). Only with such a document can translators help bring the greatness of Drupal to a new population of developers. Without such a document, it becomes difficult to convince those interested in Drupal that it is well documented even in English.</p> >>> [!note] Pre-migration files - [newdocpage.png](https://www.drupal.org/files/issues/newdocpage.png) >>>