>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #3336990. --> Reported by: [batigolix](https://www.drupal.org/user/22175) >>> <p>Documentation of this module can be improved in various aspects:</p> <p>1. The documentation can be found here: <a href="https://www.drupal.org/docs/contributed-modules/office-365-connector">https://www.drupal.org/docs/contributed-modules/office-365-connector</a>, but also here <a href="https://git.drupalcode.org/project/o365/-/blob/4.0.x/README.md">https://git.drupalcode.org/project/o365/-/blob/4.0.x/README.md</a>.<br> Better use one source only to act as a single point of truth (and let the second source refer to the first), or keep both sources equal.</p> <p>2. Include an overview of all submodules + one line description instead of an example of some submodules, <a href="https://git.drupalcode.org/project/o365/-/blob/4.0.x/README.md">https://git.drupalcode.org/project/o365/-/blob/4.0.x/README.md</a> (The one line description would also come in handy here <a href="https://www.drupal.org/docs/contributed-modules/office-365-connector">https://www.drupal.org/docs/contributed-modules/office-365-connector</a>. It may help in deciding which submodules to install or not.)</p> <p>3. The Office 365 - Profiles and Personas REST submodule is missing from the submodules overview <a href="https://www.drupal.org/docs/contributed-modules/office-365-connector">https://www.drupal.org/docs/contributed-modules/office-365-connector</a></p> <p>4. <a href="https://git.drupalcode.org/project/o365/-/blob/4.0.x/README.md">https://git.drupalcode.org/project/o365/-/blob/4.0.x/README.md</a> (INSTALLATION) and <a href="https://www.drupal.org/docs/contributed-modules/office-365-connector">https://www.drupal.org/docs/contributed-modules/office-365-connector</a> (Installing the module) are both referring to a url how to install a generic contrib Dupral module.<br> Better provide the specific example how to install the O365 module.</p> <p>5. <a href="https://git.drupalcode.org/project/o365/-/blob/4.0.x/README.md">https://git.drupalcode.org/project/o365/-/blob/4.0.x/README.md</a> (CONFIGURATION) show three app data settings (client_id, client_secret, and tenant_id) while <a href="https://www.drupal.org/docs/contributed-modules/office-365-connector/setting-up-an-azure-app">https://www.drupal.org/docs/contributed-modules/office-365-connector/setting-up-an-azure-app</a> shows four (+ website url) and the grey block show five (+ redirect_callback).</p> <p>6. <a href="https://www.drupal.org/docs/contributed-modules/office-365-connector/setting-up-an-azure-app">https://www.drupal.org/docs/contributed-modules/office-365-connector/setting-up-an-azure-app</a>, being unfamiliar with Azure, the meaning of the options for point 3 (single tenant, multi tenant, etc.) are unclear (to me).</p> <p>7. What should we do after we have completed all the steps here <a href="https://www.drupal.org/docs/contributed-modules/office-365-connector/setting-up-an-azure-app">https://www.drupal.org/docs/contributed-modules/office-365-connector/setting-up-an-azure-app</a>? Go to the next page, or..?</p> <p>8. <a href="https://www.drupal.org/docs/contributed-modules/office-365-connector/general-information">https://www.drupal.org/docs/contributed-modules/office-365-connector/general-information</a> talks about #blocks. Is this general information?</p> <p>9. See bottom of <a href="https://www.drupal.org/docs/contributed-modules/office-365-connector">https://www.drupal.org/docs/contributed-modules/office-365-connector</a> Related Content may be removed? Introduction is not clickable, Office 365 Connector links back to the project.</p> <p>10. The submodules lack some more explanation or description. (e.g. <a href="https://www.drupal.org/docs/contributed-modules/office-365-connector/3-submodules/office-365-sharepoint-file-search">https://www.drupal.org/docs/contributed-modules/office-365-connector/3-submodules/office-365-sharepoint-file-search</a>) Or maybe update the product roadmap so users know better what they can expect in future.</p>