>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3087206. --> Reported by: [phenaproxima](https://www.drupal.org/user/205645) >>> <h3 id="summary-problem-motivation">Problem/Motivation</h3> <p>The Media Library module's handbook docs have some TODOs to link to other parts of the online drupal.org documentation.</p> <p>Additionally, the docs could probably stand to be structured a bit more optimally (for example, not combining content author-facing docs and site builder-facing docs on the same page).</p> <h3 id="summary-proposed-resolution">Proposed resolution</h3> <p>Here are a few outstanding places the docs under <a href="https://www.drupal.org/docs/8/core/modules/media-library-module">https://www.drupal.org/docs/8/core/modules/media-library-module</a>, which are already <em>amazing</em>, could be improved:</p> <ul> <li>Explain how to customize the fields available when adding media at <a href="https://www.drupal.org/docs/8/core/modules/media-library-module/overview">https://www.drupal.org/docs/8/core/modules/media-library-module/overview</a></li> <li>Explain the "Media Library settings" option to "Enable advanced UI" (at <a href="https://www.drupal.org/docs/8/core/modules/media-library-module/overview">https://www.drupal.org/docs/8/core/modules/media-library-module/overview</a> -- just keep in mind it also affects the WYSIWYG + media library UX)</li> <li>In <a href="https://www.drupal.org/docs/8/core/modules/media-library-module/the-media-library-field-widget">https://www.drupal.org/docs/8/core/modules/media-library-module/the-media-library-field-widget</a>, cross-link to instructions on setting up an entity reference field.</li> <li>Under "Embedding media in CKEditor" in <a href="https://www.drupal.org/docs/8/core/modules/media-library-module/embedding-media-with-ckeditor">https://www.drupal.org/docs/8/core/modules/media-library-module/embedding-media-with-ckeditor</a>, cross-link how you set up a media reference field.</li> <li>In <a href="https://www.drupal.org/docs/8/core/modules/media-library-module/administering-the-media-library">https://www.drupal.org/docs/8/core/modules/media-library-module/administering-the-media-library</a>, let's pick an audience for that&mdash;either site builders or content authors&mdash;and move the remaining info to another page.</li> <li>Also figure out what's up with that page not showing up in the sidebar? (just needs maintainer review/approval, or?</li> </ul> <h3 id="summary-remaining-tasks">Remaining tasks</h3> <p>Do those things.</p> <h3 id="summary-ui-changes">User interface changes</h3> <p>Not much.</p> <h3 id="summary-api-changes">API changes</h3> <p>N/A</p> <h3 id="summary-data-model-changes">Data model changes</h3> <p>N/A</p> <h3 id="summary-release-notes">Release notes snippet</h3> <p>N/A</p>