Skip to content

docs(seo): SPARROW content depth + long-tail (edge/field lane)#63

Merged
zhmiao merged 2 commits into
seo/sparrow-infra-structured-datafrom
seo/sparrow-content
Jun 4, 2026
Merged

docs(seo): SPARROW content depth + long-tail (edge/field lane)#63
zhmiao merged 2 commits into
seo/sparrow-infra-structured-datafrom
seo/sparrow-content

Conversation

@rain-Brian
Copy link
Copy Markdown
Collaborator

What this does

Builds out content depth and long-tail SEO coverage for the SPARROW docs site, scoped entirely to the edge device / hardware / connectivity / field-deployment keyword lane (how to collect biodiversity data in remote places). SEO/docs only: changes are limited to docs/** and the mkdocs.yml nav.

New pages

  • docs/edge-ai-wildlife-monitoring.md — positioning / overview: what SPARROW is, who it is for, why the AI runs at the edge. Targets edge AI biodiversity + wildlife monitoring device.
  • docs/field-deployment.md — siting, solar power planning, Starlink connectivity behaviour, camera-trap networking, and field maintenance. Targets remote wildlife monitoring + Starlink wildlife.
  • docs/limitations.md — honest constraints: power (solar), connectivity (intermittent), weather, and local storage, plus scope boundaries.

Deepened pages

  • docs/hardware.md — retitled to Hardware and Architecture; added a "how the subsystems fit together" section; keyword-first front matter plants solar powered camera trap, NVIDIA Jetson camera trap, and Starlink wildlife.
  • docs/index.md — leads with a one-sentence value proposition and links out to the new pages; Getting Started expanded.
  • docs/setup.md, docs/cite.md, docs/build_mkdocs.md — light cross-link / front-matter touch-ups and em-dash removal.
  • mkdocs.yml — new pages added to nav; em-dash removed from site_description.

Keyword lane and cluster boundaries

  • Lane: edge device / hardware / connectivity / field deployment. The pages do not compete with sibling repos.
  • Audio classification is pointed at MegaDetector-Acoustic as the owner; SPARROW only claims audio capture (AudioMoth as a data-collection sensor).
  • Camera-trap detection is pointed at MegaDetector; SPARROW runs it on-device but does not try to rank for detection.
  • Each new page links back to the Microsoft Biodiversity hub and carries a "Related Microsoft biodiversity AI projects" block with lane distinctions. Each new page has 5 inbound internal links.

Gates

  • mkdocs build --strict: passes (exit 0), all three new pages render, no link/nav warnings.
  • Em-dash: grep -rn '—' docs/ mkdocs.yml is clean.
  • Originality: new pages paraphrase and restructure; no verbatim README paragraphs copied (spot-checked).
  • Front matter on every new/edited page: unique keyword-first title, description 110-160 chars, lane-scoped tags.

Stacking

Stacked on the infra PR #62 (seo/sparrow-infra-structured-data). Base is set to that branch; on merge of #62 the base auto-retargets to main.

Claims to verify (@zhmiao)

None. All facts (2x100W panels, MPPT controller, 24V LiFePO4 50-100Ah battery, dynamic power scheduling, Starlink Mini uplink, store-and-forward sync, scheduled Starlink sleep window, 2TB NVMe buffer, up to 150 WiFi cameras, on-device privacy scrubbing, IP65 enclosure) are sourced from the existing README and docs. No specs, part numbers, or performance figures were invented.

Add three lane-scoped pages and deepen existing ones for the edge
device / hardware / connectivity / field-deployment keyword lane:

- New: edge-ai-wildlife-monitoring.md (positioning, who it is for)
- New: field-deployment.md (siting, power, Starlink connectivity, maintenance)
- New: limitations.md (power, connectivity, weather, storage)
- Deepen hardware.md into hardware + architecture, keyword-first front matter
- Lead index.md with the value proposition; expand Getting Started
- Cross-link the cluster (hub + MegaDetector / MegaDetector-Acoustic /
  PyTorch-Wildlife) with lane distinctions; keep audio analysis pointed
  at MegaDetector-Acoustic and image detection at MegaDetector
- Remove em-dashes from touched docs and mkdocs.yml site_description

Sourced only from existing README and docs; no invented specs.
…s URL is stable

The related-project cross-links pointed at Acoustic's canonical Pages URL, which
301-redirects while the repo is private. Name it as 'documentation coming soon'
without the live link; the audio-classification deferral (this repo collects/owns
its own modality, Acoustic owns audio analysis) is unchanged. Re-add the link on go-public.
@rain-Brian rain-Brian requested a review from zhmiao June 3, 2026 22:22
@zhmiao zhmiao merged commit 0f216ce into seo/sparrow-infra-structured-data Jun 4, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants