>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #1142004. --> Reported by: [arianek](https://www.drupal.org/user/158886) >>> <p>Carolyn mentioned something I've been meaning to do for ages on <span class="drupalorg-gitlab-issue-link drupalorg-gitlab-link-wrapper"><a href="https://git.drupalcode.org/project/documentation/-/work_items/674474" class="drupalorg-gitlab-link">https://git.drupalcode.org/project/documentation/-/work_items/674474</a></span>, so thought I'd start an issue. We should really create a standard/template for module docs landing pages (ie. the top level page for a particular module). This would provide a consistent guideline for core, and a suggested guideline for contrib as well.</p> <p>URL alias should always be: <code>http://drupal.org/documentation/modules/[project-name]</code> - these are all set for core modules, and I do contrib ones as I find them.</p> <p>Generally it should also loosely follow what's in the Help pages since that's where a lot of the D7 content came from. So something like:</p> <h2>[About/Intro]</h2> <p>Brief intro (not sure we need to actually put this as a heading like in Help we use "About").</p> <h2>Uses</h2> <p>Use cases, and what the module's config options are - optionally divided into D7 then D6 subsections.</p> <h2>Configuration</h2> <p>Configuration instructions and options. (Could be called "Implementation" - or would that be too technical?)</p> <h2>Technical Specifications for Drupal 7</h2> <p>Eg. from Carolyn for Block module based on Ken Rickard's Field UI docs work:</p> <p>Core module: Yes.<br> Dependencies: None.<br> Related Modules: Dashboard.<br> Permissions: Administer blocks. Also see the API docs at <a href="hthttp://api.drupal.org/api/drupal/modules--block--block.module/function/block_permission/7">block permission</a>.<br> API Documentation: <a href="http://api.drupal.org/api/drupal/modules--block--block.admin.inc/7">block.admin.inc</a>, <a href="http://api.drupal.org/api/drupal/modules--block--block.api.php/7">block.api.php</a>, <a href="http://api.drupal.org/api/drupal/modules--block--block.install/7">block.install</a>, <a href="http://api.drupal.org/api/drupal/modules--block--block.module/7">block.module</a>, <a href="http://api.drupal.org/api/drupal/modules--block--tests--block_test.module/7">block_test.module</a><br> Template files: <a href="http://api.drupal.org/api/drupal/modules--block--block-admin-display-form.tpl.php/7">block-admin-display-form.tpl.php</a>, <a href="http://api.drupal.org/api/drupal/modules--block--block.tpl.php/7">block.tpl.php</a><br> Other files: block.info, block.css, block.js<br> Database tables (4): block, block_role, block_custom, cache block. Also see the API docs at <a href="http://api.drupal.org/api/drupal/modules--block--block.install/function/block_schema/7">block schema</a>.</p>