Add docs to microsite

Closes #4627

Signed-off-by: Oliver Sand <oliver.sand@sda-se.com>

docs/integrations/azure/locations.md

@@ -6,8 +6,8 @@ sidebar_label: Locations
 description: Integrating source code stored in Azure DevOps into the Backstage catalog
 ---
 
-The Azure integration supports loading catalog entities from Azure DevOps.
-Entities can be added to
+The Azure DevOps integration supports loading catalog entities from Azure
+DevOps. Entities can be added to
 [static catalog configuration](../../features/software-catalog/configuration.md),
 or registered with the
 [catalog-import](https://github.com/backstage/backstage/tree/master/plugins/catalog-import)

docs/integrations/azure/org.md

@@ -0,0 +1,14 @@
+---
+id: org
+title: Microsoft Azure Active Directory Organizational Data
+sidebar_label: Org Data
+# prettier-ignore
+description: Importing users and groups from a Microsoft Azure Active Directory into Backstage
+---
+
+The Backstage catalog can be set up to ingest organizational data - users and
+teams - directly from an tenant in Microsoft Azure Active Directory via the
+Microsoft Graph API.
+
+More details on this are available in the
+[README of the `@backstage/plugin-catalog-backend-module-msgraph` package](https://github.com/backstage/backstage/blob/master/plugins/catalog-backend-module-msgraph/README.md).

microsite/sidebars.json

@@ -102,8 +102,11 @@
       "integrations/index",
       {
         "type": "subcategory",
-        "label": "Azure DevOps",
-        "ids": ["integrations/azure/locations"]
+        "label": "Azure",
+        "ids": [
+          "integrations/azure/locations", 
+          "integrations/azure/org"
+        ]
       },
       {
         "type": "subcategory",

mkdocs.yml

@@ -75,8 +75,9 @@ nav:
           - FAQ: 'features/techdocs/FAQ.md'
   - Integrations:
       - Overview: 'integrations/index.md'
-      - Azure DevOps:
+      - Azure:
           - Locations: 'integrations/azure/locations.md'
+          - Org Data: 'integrations/azure/org.md'
       - Bitbucket:
           - Locations: 'integrations/bitbucket/locations.md'
           - Discovery: 'integrations/bitbucket/discovery.md'

plugins/catalog-backend-module-msgraph/README.md

@@ -3,7 +3,7 @@
 This is an extension module to the `plugin-catalog-backend` plugin, providing a
 `MicrosoftGraphOrgReaderProcessor` that can be used to ingest organization data
 from the Microsoft Graph API. This processor is useful if you want to import
-users and groups from Office 365.
+users and groups from Azure Active Directory or Office 365.
 
 ## Getting Started