-
Notifications
You must be signed in to change notification settings - Fork 0
Open
Labels
Description
Add azurelocal.cloud and all subsites to Google Search Console, Google Analytics, and Bing Webmaster Tools
Problem
Our documentation sites are not registered with search engines or analytics platforms. This means:
- Pages are not indexed (or poorly indexed) by Google and Bing
- We have no visibility into search traffic, impressions, or click-through rates
- We cannot submit sitemaps for faster crawling
- We have no analytics data on how users find and navigate our docs
Sites to Register
| Site | URL | Platform |
|---|---|---|
| Azure Local Docs (main) | https://azurelocal.cloud | Docusaurus |
| AVD Docs | https://azurelocal.cloud/azurelocal-avd/ (or MkDocs subdomain/path) | MkDocs |
| SOFS FSLogix Docs | https://azurelocal.cloud/azurelocal-sofs-fslogix/ (or MkDocs subdomain/path) | MkDocs |
| Load Tools Docs | https://azurelocal.cloud/azurelocal-loadtools/ | MkDocs |
| VM Conversion Toolkit Docs | https://azurelocal.cloud/azurelocal-vm-conversion-toolkit/ | MkDocs |
| Toolkit Docs | https://azurelocal.cloud/azurelocal-toolkit/ | MkDocs |
Note: Verify the actual deployed URLs for each subsite — some may be on GitHub Pages subpaths or separate subdomains.
Tasks
Google Search Console
- Register and verify
azurelocal.cloudas a property - Add all subsites as URL prefix properties (or use domain-level verification)
- Submit sitemaps for each site (
sitemap.xml) - Verify indexing status and request indexing for key pages
- Set preferred domain and international targeting if applicable
Google Analytics (GA4)
- Create a GA4 property for
azurelocal.cloud - Add the GA4 measurement tag to the Docusaurus config (
docusaurus.config.js→gtagplugin) - Add GA4 tracking to each MkDocs site (
mkdocs.yml→google_analyticsor customextraconfig) - Verify real-time data is flowing from all sites
- Set up basic reports: page views, traffic sources, top pages, user geography
Bing Webmaster Tools
- Register and verify
azurelocal.cloud - Submit sitemaps for all sites
- Verify indexing status
- Review SEO reports and fix any flagged issues
SEO Basics
- Ensure all sites generate
sitemap.xml(Docusaurus and MkDocs both do this by default) - Ensure
robots.txtexists and allows crawling - Add
<meta>description tags to key pages if missing - Verify Open Graph / social preview tags are set for link sharing
Acceptance Criteria
- All sites verified in Google Search Console
- Sitemaps submitted and pages indexed in Google
- GA4 tracking active on all sites with real-time data confirmed
- All sites verified in Bing Webmaster Tools
- Sitemaps submitted to Bing
-
robots.txtandsitemap.xmlaccessible on all sites
Reactions are currently unavailable