microsoft / microsoft/aspire.dev

GEO: Plan to surface the Aspire brand in AI search through organic visibility

Open
#702 1 comment 1 reaction 1 assignee Claimed by @BethMassi View on GitHub
Dominant language
MDX
Stars
193
Forks
87
Avg merge
1d 22h
Merged PRs (30d)
73

Description

## Phase 1
**Goal:** make Aspire easier for search engines and LLMs to identify, parse, and trust.

- [x] Add `Organization` and `WebSite` JSON-LD to the home page. #681
- [x] Add `Article`/`TechArticle` + `BreadcrumbList` + `dateModified` JSON-LD to (at least) the top 25 docs pages. #681
- [x] Publish FAQ #690 #701
- [ ] Update titles, meta descriptions, and H1s so each page clearly targets one user intent.

## Phase 2
**Goal:** increase the number of questions Aspire can win organically.

- [ ] Review troubleshooting page(s).
- Perhaps start with `aspire update` or teach people about `--debug` or `aspire diagnostics` and then move to integration troubleshooting.
- [ ] Add page-specific FAQs to the highest-traffic docs pages.
- [ ] Add more tables, checklists, and "quick answers" to install, first-app, and AI-agent pages.
- [ ] Add IndexNow submission to the docs release pipeline (we can do this manually through ahrefs console for now)

## Phase 3
**Goal:** make Aspire the source AI systems quote, not just a site they can crawl.

- [ ] Publish at least 3 case studies that show measurable results using Aspire.
- [ ] Synchronize brand language and links across GitHub, Learn, blog posts, and talks.
- This is done across the channels we own.
- Next step is to refer to Aspire from relevant Microsoft Learn docs as that has very high domain authority.
- Publish brand assets and usage guidelines, design language, and intro decks to aspire-brand repo
- [x] Refresh pages monthly based on real prompt testing and Search Console performance.
- We're set up in ahrefs now so we can now monitor everything from there.

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.