Merge pull request #25523 from github/repo-sync

repo sync

content/admin/configuration/configuring-your-enterprise/configuring-applications.md

@@ -34,3 +34,18 @@ You can enable a retention policy for checks, actions, and associated data by se
 4. Under "Delete threshold (days)", type the number of days for the deletion threshold. Archived checks older than this number of days will be permanently deleted. 
 {% data reusables.enterprise_management_console.save-settings %}
 {% endif %}
+
+{% ifversion azure-maps %}
+## Enabling interactive maps
+
+You can allow users to create interactive maps using GeoJSON or TopoJSON syntax. For more information, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams#creating-geojson-and-topojson-maps)."
+
+To enable interactive maps on {% data variables.location.product_location %}, you must enable the feature and provide a public authentication token for Azure. For more information, see [Authentication with Azure Maps](https://learn.microsoft.com/en-us/azure/azure-maps/azure-maps-authentication) in the Microsoft Docs.
+
+{% data reusables.enterprise_site_admin_settings.access-settings %}
+{% data reusables.enterprise_site_admin_settings.management-console %}
+1. In the "Settings" sidebar, click **Privacy**.
+1. To enable interactive maps, select "Enable GeoJSON rendering".
+1. To configure authentication, under "Azure Maps API Token", paste your token.
+{% data reusables.enterprise_management_console.save-settings %}
+{% endif %}

content/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams.md

@@ -40,7 +40,9 @@ graph TD;
 
 ## Creating GeoJSON and TopoJSON maps
 
-You can use GeoJSON/TopoJSON syntax to create interactive maps. To create a map, add GeoJSON or TopoJSON inside a fenced code block with the `geojson` or `topojson` syntax identifier. For more information, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks)."
+You can use GeoJSON or TopoJSON syntax to create interactive maps. To create a map, add GeoJSON or TopoJSON inside a fenced code block with the `geojson` or `topojson` syntax identifier. For more information, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/creating-and-highlighting-code-blocks)."
+
+{% data reusables.advanced-formatting.administrator-must-enable-mapping %}
 
 ### Using GeoJSON
 

content/repositories/working-with-files/using-files/working-with-non-code-files.md

@@ -278,6 +278,8 @@ By default, the embedded map 420px x 620px, but you can customize the output by
 ### Mapping in Markdown
 
 You can embed GeoJSON and TopoJSON directly in Markdown. For more information, see "[AUTOTITLE](/get-started/writing-on-github/working-with-advanced-formatting/creating-diagrams#creating-geojson-and-topojson-maps)."
+
+{% data reusables.advanced-formatting.administrator-must-enable-mapping %}
 {% endif %}
 
 ### Clustering

data/features/azure-maps.yml

@@ -0,0 +1,3 @@
+# Documentation for enterprise only (>=3.7) specifying that admins need to provide their own Azure Maps token
+versions:
+  ghes: '>=3.7'

data/reusables/advanced-formatting/administrator-must-enable-mapping.md

@@ -0,0 +1,5 @@
+{% ifversion azure-maps %}
+
+To display interactive maps, a site administrator must configure the feature for {% data variables.location.product_location %}. For more information, see "[AUTOTITLE](/admin/configuration/configuring-your-enterprise/configuring-applications#enabling-interactive-maps)."
+
+{% endif %}