Skip to content

docs: SPARROW ecosystem alignment — MkDocs site, citation, issue templates, branding#51

Open
rain-Brian wants to merge 3 commits into
mainfrom
docs/sparrow-ecosystem-alignment
Open

docs: SPARROW ecosystem alignment — MkDocs site, citation, issue templates, branding#51
rain-Brian wants to merge 3 commits into
mainfrom
docs/sparrow-ecosystem-alignment

Conversation

@rain-Brian
Copy link
Copy Markdown
Collaborator

Summary

  • MkDocs docs site: mkdocs.yml, docs-requirements.txt, and docs/ with 6 pages (index, hardware setup, software setup, cite, tags, developer guide) — all with SEO description + tags front matter; mkdocs build passes clean
  • GitHub Actions: .github/workflows/deploy-docs.yml — auto-deploys to GitHub Pages on push to main (triggers on docs/**, mkdocs.yml, docs-requirements.txt)
  • citation.cff: Software citation with all 16 authors from the SPARROW paper
  • Issue templates: bug-report.yml, feature-request.yml, question.yml (.github/ISSUE_TEMPLATE/)
  • SUPPORT.md: Replaced TODO placeholder content with real support guidance (GitHub Issues + Discussions)
  • README.md: Hero image alt text added; PyTorch WildlifePyTorch-Wildlife (line 40 prose); Biodiversity ecosystem table added
  • .gitignore: Added site/, archive/, *.code-workspace

Post-merge steps (manual — requires org admin)

  • GitHub repo Settings → Homepage: https://microsoft.github.io/SPARROW/
  • GitHub repo Settings → Topics: sparrow, edge-ai, camera-traps, wildlife-monitoring, conservation, ai-for-good, jetson, docker, solar-powered, pytorch-wildlife
  • GitHub repo Settings → Description: "SPARROW: Solar-Powered Acoustic and Remote Recording Observation Watch — AI-powered edge computing for wildlife monitoring."

Test plan

  • mkdocs build passes with no errors (verified locally)
  • Docs site deploys to GitHub Pages after merge (GitHub Actions workflow fires)
  • Issue templates appear when creating a new issue
  • citation.cff recognized by GitHub "Cite this repository" button

…randing fixes

- Add MkDocs docs site (mkdocs.yml, docs-requirements.txt, deploy-docs.yml)
- Add docs/ with 6 pages: index, hardware, setup, cite, tags, build_mkdocs
- Add citation.cff (16 authors, software citation)
- Add .github/ISSUE_TEMPLATE/ (bug-report, feature-request, question)
- Fix SUPPORT.md: replace TODO placeholders with real support guidance
- Fix README.md: hero image alt text, PyTorch-Wildlife branding, ecosystem table
- Add site/, archive/, *.code-workspace to .gitignore
- index.md: add architecture diagram, capabilities table, use-case summary
- hardware.md: full BOM component tables by category (Jetson, solar, Starlink, AudioMoth, camera)
- setup.md: setup script step table, folder layout, AI models (Triton/ONNX), Docker services detail, dashboard links
File contained only a blank line and had a typo in the filename (piplines).
@rain-Brian rain-Brian requested a review from zhmiao May 14, 2026 20:22
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