docs(seo): add intent pages, topics checklist, backlink plan, and release drafts

.github/release_template.md

@@ -19,3 +19,5 @@
 ## References
 - Changelog: [CHANGELOG.md](../CHANGELOG.md)
 - Release checklist: [docs/release_checklist.md](../docs/release_checklist.md)
+- Release notes draft v0.1.1: [docs/release_v0.1.1.md](../docs/release_v0.1.1.md)
+- Release notes draft v0.1.2: [docs/release_v0.1.2.md](../docs/release_v0.1.2.md)

CHANGELOG.md

@@ -7,13 +7,17 @@ and this project uses milestone-style tags (for example `v0.1`, `v0.2`).
 
 ## [Unreleased]
 ### Added
-- Placeholder for upcoming additions.
+- Hugging Face model-card metadata at the top of `README.md`.
+- GitHub topics checklist (`docs/github_topics_checklist.md`).
+- Backlink strategy plan (`docs/backlink_strategy.md`).
+- SEO intent landing pages for Pashto datasets, ASR, and TTS.
+- Release note drafts for `v0.1.1` and `v0.1.2`.
 
 ### Changed
-- Placeholder for upcoming changes.
+- Expanded documentation map to include SEO operations and intent pages.
 
 ### Fixed
-- Placeholder for upcoming fixes.
+- Finalized hardcoded URL coverage for the `pashto-language-resources` slug across docs and release notes.
 
 ## [v0.1] - 2026-02-14
 ### Added

README.md

@@ -1,3 +1,21 @@
+---
+license: apache-2.0
+language:
+- ps
+- en
+tags:
+- pashto
+- pukhto
+- pushto
+- asr
+- tts
+- nlp
+- machine-translation
+- language-resources
+- low-resource-languages
+- speech-recognition
+---
+
 # Pashto Language Resources Hub (Pukhto/Pashto)
 
 Open-source repository for Pashto language technology resources: datasets, models, benchmarks, ASR, TTS, NLP, and machine translation (MT).
@@ -68,6 +86,13 @@ python -m pytest -q
 - Resource search page: [docs/search/index.html](docs/search/index.html)
 - Citation metadata: [CITATION.cff](CITATION.cff)
 - Platform sync policy: [docs/platform_sync_policy.md](docs/platform_sync_policy.md)
+- GitHub topics checklist: [docs/github_topics_checklist.md](docs/github_topics_checklist.md)
+- Backlink strategy: [docs/backlink_strategy.md](docs/backlink_strategy.md)
+- Intent page: [Pashto datasets](docs/pashto_datasets.md)
+- Intent page: [Pashto ASR](docs/pashto_asr.md)
+- Intent page: [Pashto TTS](docs/pashto_tts.md)
+- Release notes: [v0.1.1](docs/release_v0.1.1.md)
+- Release notes: [v0.1.2](docs/release_v0.1.2.md)
 
 ## Documentation Map
 
@@ -101,5 +126,3 @@ python -m pytest -q
 - [experiments/](experiments/README.md): reproducible run cards
 - [apps/desktop/](apps/desktop/README.md): user-facing integration references
 - [models/](models/README.md): model layout and release conventions
-
-

docs/README.md

@@ -17,6 +17,8 @@ This folder is the main documentation entry point for contributors.
 - Common Voice Pashto integration: [common_voice_pashto_24.md](common_voice_pashto_24.md)
 - Discoverability and SEO playbook: [discoverability_seo.md](discoverability_seo.md)
 - Platform sync policy: [platform_sync_policy.md](platform_sync_policy.md)
+- GitHub topics checklist: [github_topics_checklist.md](github_topics_checklist.md)
+- Backlink strategy: [backlink_strategy.md](backlink_strategy.md)
 - Release process: [release_process.md](release_process.md)
 - Release checklist: [release_checklist.md](release_checklist.md)
 - Platforms and publish flow: [platforms.md](platforms.md)
@@ -24,6 +26,15 @@ This folder is the main documentation entry point for contributors.
 - Resource automation: [resource_automation.md](resource_automation.md)
 - Resource cycle runbook: [resource_cycle_runbook.md](resource_cycle_runbook.md)
 
+## Intent landing pages
+- Pashto datasets page: [pashto_datasets.md](pashto_datasets.md)
+- Pashto ASR page: [pashto_asr.md](pashto_asr.md)
+- Pashto TTS page: [pashto_tts.md](pashto_tts.md)
+
+## Release notes
+- v0.1.1 draft notes: [release_v0.1.1.md](release_v0.1.1.md)
+- v0.1.2 draft notes: [release_v0.1.2.md](release_v0.1.2.md)
+
 ## Resource tracking
 - Master resource index: [resource_catalog.md](resource_catalog.md)
 - GitHub Pages search: [search/index.html](search/index.html)

docs/backlink_strategy.md

@@ -0,0 +1,64 @@
+# Backlink Strategy
+
+Goal: increase discoverability of Pashto AI resources by earning high-quality links to this repository and its searchable pages.
+
+## Priority Destination URLs
+
+- Home page: [Pashto Language Resources home](https://musawer1214.github.io/pashto-language-resources/)
+- Search page: [Pashto resource search](https://musawer1214.github.io/pashto-language-resources/search/)
+- Repository: [Musawer1214/pashto-language-resources](https://github.com/Musawer1214/pashto-language-resources)
+
+## Link Building Targets
+
+- Pashto/NLP community resource lists.
+- University lab pages working on low-resource languages.
+- Research paper reproducibility pages (appendix/code links).
+- Awesome-list maintainers for speech/NLP resources.
+- Hugging Face model and dataset cards that reference this hub.
+
+## Outreach Plays
+
+1. Documentation backlinks
+- Add this repository to relevant READMEs and curated resource pages.
+- Ask collaborators to link specific intent pages (datasets, ASR, TTS).
+
+2. Research backlinks
+- When publishing results, include repository + exact page links in `Code` and `Data availability` sections.
+
+3. Community backlinks
+- Share monthly update posts with direct links to release notes and search page.
+
+## Anchor Text Guidance
+
+Preferred anchors:
+- Pashto language resources
+- Pashto ASR resources
+- Pashto TTS resources
+- Pashto datasets
+
+Avoid repeated exact-match overuse; vary naturally.
+
+## Tracking
+
+Track monthly in a simple sheet:
+
+- Source URL
+- Destination URL
+- Anchor text
+- Domain type (academic, community, code, media)
+- Date added
+- Follow-up status
+
+## KPI Targets (Quarterly)
+
+- 15+ new relevant referring pages.
+- 3+ new links from academic/lab domains.
+- Increased branded queries for `pashto-language-resources`.
+- Higher impressions for `pashto datasets`, `pashto asr`, `pashto tts`.
+
+## Related Docs
+
+- [Discoverability and SEO](discoverability_seo.md)
+- [GitHub topics checklist](github_topics_checklist.md)
+- [Release process](release_process.md)
+

docs/discoverability_seo.md

@@ -66,6 +66,13 @@ Keep these updated when renaming slug or domain.
   - Conference/demo pages for Pashto language technology
 - Ask contributors to link specific resource pages in blog posts or papers.
 
+## SEO Operation Assets
+
+- GitHub topics checklist: [github_topics_checklist.md](github_topics_checklist.md)
+- Backlink strategy: [backlink_strategy.md](backlink_strategy.md)
+- Intent page: [Pashto datasets](pashto_datasets.md)
+- Intent page: [Pashto ASR](pashto_asr.md)
+- Intent page: [Pashto TTS](pashto_tts.md)
 ## 6) Indexing Checklist (After Push)
 
 1. Push all changes to `main`.
@@ -82,3 +89,4 @@ Keep these updated when renaming slug or domain.
    - Search page
 6. Recheck search visibility after 1 to 3 weeks.
 
+

docs/github_topics_checklist.md

@@ -0,0 +1,45 @@
+# GitHub Topics Checklist
+
+Use this checklist to keep repository topics aligned with search intent and discoverability.
+
+## Recommended Topics
+
+- pashto
+- pukhto
+- pushto
+- asr
+- tts
+- nlp
+- machine-translation
+- speech-recognition
+- language-resources
+- low-resource-languages
+- multilingual
+- dataset-curation
+
+## Manual Update Steps
+
+1. Open repository home page.
+2. In the right `About` panel, click the gear icon.
+3. Add or update topics.
+4. Save changes.
+
+## Monthly Audit Checklist
+
+- [ ] Topics match project scope (ASR, TTS, NLP, MT, resources).
+- [ ] Synonyms are present (pashto, pukhto, pushto).
+- [ ] No stale or misleading topics remain.
+- [ ] README keywords and topics are still consistent.
+- [ ] GitHub Pages home and search links are present in About website/docs.
+
+## Validation Commands
+
+```bash
+rg -n "pashto|pukhto|pushto|asr|tts|nlp|machine-translation" README.md docs
+```
+
+## Related Docs
+
+- [Discoverability and SEO](discoverability_seo.md)
+- [Backlink strategy](backlink_strategy.md)
+- [Platform sync policy](platform_sync_policy.md)

docs/index.md

@@ -30,6 +30,12 @@ description: Open-source Pashto (Pukhto/Pashto) datasets, models, benchmarks, AS
 - Resource index docs: [resource_catalog.md](resource_catalog.md)
 - Machine-readable catalog (GitHub): [resources.json source](https://github.com/Musawer1214/pashto-language-resources/blob/main/resources/catalog/resources.json)
 
+## Intent Pages
+
+- Pashto datasets: [pashto_datasets.md](pashto_datasets.md)
+- Pashto ASR resources: [pashto_asr.md](pashto_asr.md)
+- Pashto TTS resources: [pashto_tts.md](pashto_tts.md)
+
 ## Project References
 
 - Repository: [Musawer1214/pashto-language-resources](https://github.com/Musawer1214/pashto-language-resources)
@@ -38,6 +44,13 @@ description: Open-source Pashto (Pukhto/Pashto) datasets, models, benchmarks, AS
 - Roadmap: [ROADMAP.md](../ROADMAP.md)
 - Contributing: [CONTRIBUTING.md](../CONTRIBUTING.md)
 
+## SEO Operations
+
+- GitHub topics checklist: [github_topics_checklist.md](github_topics_checklist.md)
+- Backlink strategy: [backlink_strategy.md](backlink_strategy.md)
+- Release notes v0.1.1: [release_v0.1.1.md](release_v0.1.1.md)
+- Release notes v0.1.2: [release_v0.1.2.md](release_v0.1.2.md)
+
 ## Contributing
 
 You can help by improving documentation, validating normalization rows, sharing verified resources, or contributing data, model, and evaluation workflows.
@@ -60,5 +73,3 @@ This project is relevant to searches like:
 ## License
 
 This project is released under Apache 2.0. See [LICENSE](../LICENSE).
-
-

docs/pashto_asr.md

@@ -0,0 +1,31 @@
+---
+title: Pashto ASR Resources
+description: Pashto automatic speech recognition resources, datasets, models, and benchmark links.
+keywords: pashto asr, pukhto speech recognition, pushto asr model
+---
+
+# Pashto ASR Resources
+
+This page targets search intent around Pashto automatic speech recognition.
+
+## Start Here
+
+- Search all resources: [Pashto resource search](search/index.html)
+- ASR workspace: [asr/README.md](../asr/README.md)
+- Models index: [resources/models/README.md](../resources/models/README.md)
+- Benchmarks index: [resources/benchmarks/README.md](../resources/benchmarks/README.md)
+
+## What You Can Find
+
+- Pashto speech datasets and transcription references.
+- ASR model checkpoints and evaluation links.
+- Benchmark notes and reproducible experiment pointers.
+
+## Related Intent Pages
+
+- [Pashto datasets](pashto_datasets.md)
+- [Pashto TTS resources](pashto_tts.md)
+
+## Contribution
+
+For ASR additions, include task definition, split info, and WER/CER style metrics when available.

docs/pashto_datasets.md

@@ -0,0 +1,30 @@
+---
+title: Pashto Datasets
+description: Curated Pashto datasets for ASR, TTS, NLP, MT, and language technology benchmarking.
+keywords: pashto datasets, pukhto dataset, pushto data, pashto nlp resources
+---
+
+# Pashto Datasets
+
+This page is for people searching for Pashto datasets across speech and text tasks.
+
+## Start Here
+
+- Search all resources: [Pashto resource search](search/index.html)
+- Dataset index: [resources/datasets/README.md](../resources/datasets/README.md)
+- Catalog overview: [resource_catalog.md](resource_catalog.md)
+
+## Dataset Coverage
+
+- Speech datasets for ASR and TTS.
+- Text corpora for NLP and MT.
+- Benchmark-ready subsets and metadata references.
+
+## Related Intent Pages
+
+- [Pashto ASR resources](pashto_asr.md)
+- [Pashto TTS resources](pashto_tts.md)
+
+## Contribution
+
+To add a dataset, follow [dataset_guidelines.md](dataset_guidelines.md) and submit a PR with evidence, license, and task tags.

docs/pashto_tts.md

@@ -0,0 +1,31 @@
+---
+title: Pashto TTS Resources
+description: Pashto text-to-speech resources, datasets, voices, and model references.
+keywords: pashto tts, pukhto text to speech, pushto speech synthesis
+---
+
+# Pashto TTS Resources
+
+This page targets search intent around Pashto text-to-speech resources.
+
+## Start Here
+
+- Search all resources: [Pashto resource search](search/index.html)
+- TTS workspace: [tts/README.md](../tts/README.md)
+- Dataset index: [resources/datasets/README.md](../resources/datasets/README.md)
+- Models index: [resources/models/README.md](../resources/models/README.md)
+
+## What You Can Find
+
+- TTS-ready Pashto corpora and audio-text pairs.
+- Voice model references and synthesis tooling.
+- Evaluation and benchmark references for speech quality.
+
+## Related Intent Pages
+
+- [Pashto datasets](pashto_datasets.md)
+- [Pashto ASR resources](pashto_asr.md)
+
+## Contribution
+
+For TTS additions, include voice/language details, licensing, and synthesis quality evidence.

docs/platform_sync_policy.md

@@ -20,6 +20,14 @@ The goal is to keep content equivalent while respecting platform differences.
 - Keep absolute links pinned to the final slug `pashto-language-resources`.
 - Keep one shared `README.md` that is valid on both platforms.
 
+## Shared Markdown Subset (GitHub + Hugging Face)
+
+Use a lowest-common-denominator style in shared docs:
+
+- Standard Markdown headings, bullet lists, links, and fenced code blocks.
+- Relative links for internal files whenever possible.
+- YAML front matter only where needed (`README.md` for HF metadata, docs pages for Jekyll SEO).
+- Avoid GitHub-only HTML widgets and avoid HF-specific custom blocks in shared files.
 ## Known Platform Differences
 
 - GitHub accepts regular Git binary blobs in many repos.
@@ -49,3 +57,4 @@ If GitHub and Hugging Face histories diverge:
 - Keep GitHub `main` as canonical source history.
 - Sync Hugging Face using a content snapshot commit based on `hf/main`.
 - Do not rewrite remote history unless explicitly required.
+

docs/release_checklist.md

@@ -1,4 +1,4 @@
-# ✅ Release Checklist
+# Release Checklist
 
 Use this checklist before tagging a new release.
 
@@ -13,3 +13,4 @@ Use this checklist before tagging a new release.
 - [ ] Run tests (`python -m pytest -q`).
 - [ ] Re-check key external resource links in [resource_catalog.md](resource_catalog.md).
 - [ ] Verify README rendering on GitHub and Hugging Face after push.
+

docs/release_v0.1.1.md

@@ -0,0 +1,38 @@
+# Release Notes Draft: v0.1.1
+
+Status: draft  
+Target date: TBD
+
+## Summary
+
+v0.1.1 focuses on discoverability improvements and cross-platform consistency between GitHub and Hugging Face.
+
+## Highlights
+
+- Added HF model-card YAML metadata to `README.md`.
+- Added SEO operations docs:
+  - `docs/github_topics_checklist.md`
+  - `docs/backlink_strategy.md`
+- Added intent landing pages:
+  - `docs/pashto_datasets.md`
+  - `docs/pashto_asr.md`
+  - `docs/pashto_tts.md`
+- Expanded docs hub and index references for new SEO content.
+
+## Validation Checklist
+
+- [ ] `python scripts/check_links.py`
+- [ ] `python scripts/validate_resource_catalog.py`
+- [ ] `python -m pytest -q`
+
+## Release Commands
+
+```bash
+git tag v0.1.1
+git push origin v0.1.1
+```
+
+## Compare
+
+- GitHub compare: [v0.1...v0.1.1](https://github.com/Musawer1214/pashto-language-resources/compare/v0.1...v0.1.1)
+

docs/release_v0.1.2.md

@@ -0,0 +1,33 @@
+# Release Notes Draft: v0.1.2
+
+Status: draft  
+Target date: TBD
+
+## Summary
+
+v0.1.2 is reserved for post-indexing improvements after monitoring search performance and backlink growth.
+
+## Planned Scope
+
+- Refine high-intent docs based on Search Console query data.
+- Expand verified resource coverage with citation-quality metadata.
+- Publish first KPI review for backlinks and discoverability metrics.
+- Tighten internal linking between docs hub, search page, and resource sections.
+
+## Validation Checklist
+
+- [ ] `python scripts/check_links.py`
+- [ ] `python scripts/validate_resource_catalog.py`
+- [ ] `python -m pytest -q`
+
+## Release Commands
+
+```bash
+git tag v0.1.2
+git push origin v0.1.2
+```
+
+## Compare
+
+- GitHub compare: [v0.1.1...v0.1.2](https://github.com/Musawer1214/pashto-language-resources/compare/v0.1.1...v0.1.2)
+

pyproject.toml

@@ -3,7 +3,7 @@ requires = ["setuptools>=68", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
-name = "pukhto-pashto"
+name = "pashto-language-resources"
 version = "0.1.0"
 description = "Open Pashto language resources for ASR, TTS, NLP, and benchmarks"
 requires-python = ">=3.10"
@@ -34,3 +34,4 @@ python_files = ["test_*.py"]
 [tool.setuptools]
 packages = []
 
+