release(v1): clean docs structure and modernize search UX

.github/release_template.md

@@ -1,23 +1,28 @@
 ## Summary
+
 - What changed in this release.
 
 ## Highlights
+
 - Data:
 - ASR:
 - TTS:
 - Benchmarks:
-- Docs/Tooling:
+- Docs and Tooling:
 
 ## Validation
+
 - Link check: `python scripts/check_links.py`
 - Normalization check: `python scripts/validate_normalization.py data/processed/normalization_seed_v0.1.tsv`
+- Resource catalog check: `python scripts/validate_resource_catalog.py`
 - Tests: `python -m pytest -q` (if available)
 
 ## Known Limitations
+
 - List current caveats.
 
 ## 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)
+- Release notes index: [docs/releases/README.md](../docs/releases/README.md)

CHANGELOG.md

@@ -3,21 +3,33 @@
 All notable changes to this project will be documented in this file.
 
 The format is inspired by [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)
-and this project uses milestone-style tags (for example `v0.1`, `v0.2`).
+and this project uses semantic version tags (for example `v1.0.0`, `v1.0.1`).
 
 ## [Unreleased]
 ### Added
-- 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`.
+- None yet.
 
 ### Changed
-- Expanded documentation map to include SEO operations and intent pages.
+- None yet.
 
 ### Fixed
-- Finalized hardcoded URL coverage for the `pashto-language-resources` slug across docs and release notes.
+- None yet.
+
+## [v1.0.0] - 2026-02-18
+### Added
+- Release notes index under `docs/releases/` with `docs/releases/v1.0.0.md`.
+- Improved discoverability assets: topics checklist, backlink strategy, and intent landing pages.
+- Hugging Face model-card metadata in `README.md`.
+
+### Changed
+- Cleaned and restructured README and docs navigation for lower redundancy.
+- Modernized `docs/search/index.html` with stronger UI/UX and interaction patterns.
+- Standardized release process and checklist around semantic versioning.
+- Updated package and citation metadata to `1.0.0`.
+
+### Fixed
+- Removed stale draft release-note references from documentation and templates.
+- Finalized hardcoded URL usage for the `pashto-language-resources` slug.
 
 ## [v0.1] - 2026-02-14
 ### Added
@@ -25,3 +37,4 @@ and this project uses milestone-style tags (for example `v0.1`, `v0.2`).
 - Structured `resources/` folder for datasets, models, benchmarks, and tools.
 - Link-check script and normalization-validator tests.
 - Documentation hub and model/release/process guidance.
+

CITATION.cff

@@ -2,7 +2,8 @@ cff-version: 1.2.0
 message: "If you use this repository, please cite it."
 title: "Pashto Language Resources Hub (Pukhto/Pashto)"
 type: software
-version: 0.1.0
+version: 1.0.0
+date-released: 2026-02-18
 license: Apache-2.0
 repository-code: "https://github.com/Musawer1214/pashto-language-resources"
 url: "https://github.com/Musawer1214/pashto-language-resources"
@@ -18,4 +19,3 @@ keywords:
   - NLP
   - machine translation
   - language resources
-

README.md

@@ -18,111 +18,66 @@ tags:
 
 # Pashto Language Resources Hub (Pukhto/Pashto)
 
-Open-source repository for Pashto language technology resources: datasets, models, benchmarks, ASR, TTS, NLP, and machine translation (MT).
+Open-source Pashto language technology hub for datasets, models, benchmarks, ASR, TTS, NLP, and machine translation.
 
-This project curates verified Pashto resources and maintains reproducible tooling for discovery, validation, and documentation.
+This repository curates verified Pashto resources and keeps validation and publishing workflows reproducible.
 
-## Start Here
+## Quick Links
 
-- Main resource search: [Pashto Resource Search](https://musawer1214.github.io/pashto-language-resources/search/)
+- Search page: [Pashto Resource Search](https://musawer1214.github.io/pashto-language-resources/search/)
 - Project site: [Pashto Language Resources Hub](https://musawer1214.github.io/pashto-language-resources/)
-- GitHub repository: [Musawer1214/pashto-language-resources](https://github.com/Musawer1214/pashto-language-resources)
+- Documentation hub: [docs/README.md](docs/README.md)
+- GitHub: [Musawer1214/pashto-language-resources](https://github.com/Musawer1214/pashto-language-resources)
 - Hugging Face mirror: [Musawer14/pashto-language-resources](https://huggingface.co/Musawer14/pashto-language-resources)
 
-## If You Searched For
+## High-Intent Pages
 
-This repository is relevant to these search intents:
+- [Pashto datasets](docs/pashto_datasets.md)
+- [Pashto ASR resources](docs/pashto_asr.md)
+- [Pashto TTS resources](docs/pashto_tts.md)
 
-- Pashto datasets
-- Pashto ASR model
-- Pashto TTS resources
-- Pashto NLP benchmark
-- Pashto machine translation resources
-- Pukhto language technology
-- Pushto AI resources
+## Repository Structure
 
-## Current Scope
+- `resources/`: verified external resources with structured categories.
+- `data/`: normalization seeds, metadata, and data workflows.
+- `asr/`: ASR notes, baselines, and references.
+- `tts/`: TTS notes, baselines, and references.
+- `benchmarks/`: schemas, result templates, and evaluation guidance.
+- `experiments/`: reproducible run-card templates.
+- `docs/`: SEO, release, platform, and contribution documentation.
 
-- Build open Pashto datasets, benchmarks, and model references for ASR, TTS, NLP, and MT.
-- Track practical tools, apps, and academic papers for Pashto integration in technology.
-- Keep everything transparent, reproducible, and contribution-friendly.
+## Resource Workflow
 
-## Resource System
+1. Discovery job (`.github/workflows/resource_sync.yml`) updates candidate feed.
+2. Maintainer review promotes high-quality entries to `resources/catalog/resources.json`.
+3. Regeneration and validation updates derived views and search index.
 
-Machine-readable and searchable resource pipeline:
-
-- Canonical catalog: [resources/catalog/resources.json](resources/catalog/resources.json)
-- Catalog schema: [resources/schema/resource.schema.json](resources/schema/resource.schema.json)
-- Candidate feed (auto-generated): [resources/catalog/pending_candidates.json](resources/catalog/pending_candidates.json)
-- Search UI source: [docs/search/index.html](docs/search/index.html)
-- Search data export: [docs/search/resources.json](docs/search/resources.json)
-- Resource index docs: [docs/resource_catalog.md](docs/resource_catalog.md)
-- Automation docs: [docs/resource_automation.md](docs/resource_automation.md)
-- Cycle runbook: [docs/resource_cycle_runbook.md](docs/resource_cycle_runbook.md)
-
-## How New Resources Are Added
-
-1. Auto discovery runs daily from `.github/workflows/resource_sync.yml` and updates `resources/catalog/pending_candidates.json` in a review PR.
-2. Manual review checks quality, Pashto evidence, and license compatibility before promoting entries into `resources/catalog/resources.json` with `status: verified`.
-3. Regeneration and validation runs `python scripts/validate_resource_catalog.py` and `python scripts/generate_resource_views.py`, then commits generated updates.
-
-Shortcut wrapper:
-- `python scripts/run_resource_cycle.py --limit 25`
-
-## Quickstart
+Core commands:
 
 ```bash
-python -m pip install -e ".[dev]"
 python scripts/validate_resource_catalog.py
 python scripts/generate_resource_views.py
 python scripts/check_links.py
 python -m pytest -q
 ```
 
-## Discoverability And SEO
+## SEO and Discoverability
 
-- Playbook: [docs/discoverability_seo.md](docs/discoverability_seo.md)
-- Docs hub: [docs/README.md](docs/README.md)
-- 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)
+- SEO playbook: [docs/discoverability_seo.md](docs/discoverability_seo.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
-
-- Purpose: [PROJECT_PURPOSE.md](PROJECT_PURPOSE.md)
-- Contributing: [CONTRIBUTING.md](CONTRIBUTING.md)
-- Roadmap: [ROADMAP.md](ROADMAP.md)
-- Governance: [GOVERNANCE.md](GOVERNANCE.md)
-- License policy: [LICENSE_POLICY.md](LICENSE_POLICY.md)
+- Platform sync policy: [docs/platform_sync_policy.md](docs/platform_sync_policy.md)
+- Search UI source: [docs/search/index.html](docs/search/index.html)
+- Citation metadata: [CITATION.cff](CITATION.cff)
+
+## Releases
+
+- Release notes index: [docs/releases/README.md](docs/releases/README.md)
+- Latest release notes: [v1.0.0](docs/releases/v1.0.0.md)
 - Changelog: [CHANGELOG.md](CHANGELOG.md)
-- Community: [community/COMMUNICATION.md](community/COMMUNICATION.md)
-- Docs hub: [docs/README.md](docs/README.md)
-- Resource index: [docs/resource_catalog.md](docs/resource_catalog.md)
-- Resource automation: [docs/resource_automation.md](docs/resource_automation.md)
-
-## Resource Sections
-
-- Datasets: [resources/datasets/README.md](resources/datasets/README.md)
-- Models: [resources/models/README.md](resources/models/README.md)
-- Benchmarks: [resources/benchmarks/README.md](resources/benchmarks/README.md)
-- Tools: [resources/tools/README.md](resources/tools/README.md)
-- Papers: [resources/papers/README.md](resources/papers/README.md)
-- Projects: [resources/projects/README.md](resources/projects/README.md)
-- Code: [resources/codes/README.md](resources/codes/README.md)
-
-## Workspaces
-
-- [data/](data/README.md): datasets, curation, metadata, quality
-- [asr/](asr/README.md): ASR baselines and experiments
-- [tts/](tts/README.md): TTS baselines and experiments
-- [benchmarks/](benchmarks/README.md): benchmark sets and evaluation
-- [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
+
+## Contributing
+
+- Contribution guide: [CONTRIBUTING.md](CONTRIBUTING.md)
+- Community communication: [community/COMMUNICATION.md](community/COMMUNICATION.md)
+- Resource guidelines: [docs/dataset_guidelines.md](docs/dataset_guidelines.md)

docs/README.md

@@ -1,8 +1,9 @@
 # Documentation Hub
 
-This folder is the main documentation entry point for contributors.
+This folder is the main documentation entry point for contributors and maintainers.
+
+## Project Foundations
 
-## Start here
 - Project purpose: [../PROJECT_PURPOSE.md](../PROJECT_PURPOSE.md)
 - Contributing guide: [../CONTRIBUTING.md](../CONTRIBUTING.md)
 - Governance: [../GOVERNANCE.md](../GOVERNANCE.md)
@@ -10,45 +11,40 @@ This folder is the main documentation entry point for contributors.
 - Roadmap: [../ROADMAP.md](../ROADMAP.md)
 - Changelog: [../CHANGELOG.md](../CHANGELOG.md)
 
-## Core documentation
-- Workstreams: [workstreams.md](workstreams.md)
-- Dataset guidelines: [dataset_guidelines.md](dataset_guidelines.md)
-- Pashto normalization policy: [pashto_normalization_v0.1.md](pashto_normalization_v0.1.md)
-- 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)
+## Discovery and SEO
+
+- Discoverability playbook: [discoverability_seo.md](discoverability_seo.md)
 - GitHub topics checklist: [github_topics_checklist.md](github_topics_checklist.md)
 - Backlink strategy: [backlink_strategy.md](backlink_strategy.md)
+- Search UI: [search/index.html](search/index.html)
+- Resource catalog docs: [resource_catalog.md](resource_catalog.md)
+
+## Intent Landing 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)
+
+## Release and Platform Operations
+
 - Release process: [release_process.md](release_process.md)
 - Release checklist: [release_checklist.md](release_checklist.md)
+- Release notes index: [releases/README.md](releases/README.md)
 - Platforms and publish flow: [platforms.md](platforms.md)
+- Platform sync policy: [platform_sync_policy.md](platform_sync_policy.md)
 - GitHub operations: [github_operations.md](github_operations.md)
-- 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)
+## Resource Automation
 
-## 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)
+- Resource automation: [resource_automation.md](resource_automation.md)
+- Resource cycle runbook: [resource_cycle_runbook.md](resource_cycle_runbook.md)
 - Structured resources folder: [../resources/README.md](../resources/README.md)
 
 ## Tooling
+
 - Scripts overview: [../scripts/README.md](../scripts/README.md)
 - Link checker: [../scripts/check_links.py](../scripts/check_links.py)
 - Resource catalog validator: [../scripts/validate_resource_catalog.py](../scripts/validate_resource_catalog.py)
 - Resource view generator: [../scripts/generate_resource_views.py](../scripts/generate_resource_views.py)
 - Candidate sync script: [../scripts/sync_resources.py](../scripts/sync_resources.py)
 - Normalization validator: [../scripts/validate_normalization.py](../scripts/validate_normalization.py)
-
-## Evaluation and experiments
-- Benchmark result format: [../benchmarks/results/README.md](../benchmarks/results/README.md)
-- Benchmark schema: [../benchmarks/schema/benchmark_result.schema.json](../benchmarks/schema/benchmark_result.schema.json)
-- Experiment run cards: [../experiments/README.md](../experiments/README.md)

docs/discoverability_seo.md

@@ -3,7 +3,7 @@
 This playbook focuses on making the repository easier to find in:
 
 - GitHub search
-- Google/Bing search
+- Google and Bing search
 - Academic and resource discovery channels
 
 ## 1) Repository Slug Status
@@ -28,7 +28,7 @@ Set these in repository `Settings -> General` and About panel:
 - Description:
   - `Open-source Pashto (Pukhto/Pashto) datasets, ASR, TTS, NLP, MT, models, and benchmark resources.`
 - Website:
-  - [GitHub Pages home](https://musawer1214.github.io/pashto-language-resources/) (final slug)
+  - [GitHub Pages home](https://musawer1214.github.io/pashto-language-resources/)
 - Topics:
   - `pashto`
   - `pukhto`
@@ -45,7 +45,7 @@ Set these in repository `Settings -> General` and About panel:
 
 - Keep the first 160 characters of `README.md` keyword clear.
 - Use consistent terminology across pages: `Pashto (Pukhto/Pushto)`.
-- Publish regular updates in `CHANGELOG.md` and GitHub Releases.
+- Publish updates through `CHANGELOG.md` and release notes in `docs/releases/`.
 - Keep `CITATION.cff` updated for scholarly reuse and citation.
 
 ## 4) Pages SEO and Crawlability
@@ -61,19 +61,21 @@ Keep these updated when renaming slug or domain.
 ## 5) External Discovery Boost
 
 - Add the GitHub Pages search URL to:
-  - Hugging Face model/dataset cards
+  - Hugging Face model and dataset cards
   - Relevant community profiles and README links
-  - Conference/demo pages for Pashto language technology
+  - Conference or demo pages for Pashto language technology
 - Ask contributors to link specific resource pages in blog posts or papers.
 
-## SEO Operation Assets
+## 6) 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)
+- Release notes index: [releases/README.md](releases/README.md)
+
+## 7) Indexing Checklist (After Push)
 
 1. Push all changes to `main`.
 2. Verify GitHub Pages is serving:
@@ -88,5 +90,3 @@ Keep these updated when renaming slug or domain.
    - Home page
    - Search page
 6. Recheck search visibility after 1 to 3 weeks.
-
-

docs/index.md

@@ -8,35 +8,25 @@ description: Open-source Pashto (Pukhto/Pashto) datasets, models, benchmarks, AS
 
 `pashto-language-resources` is a community-led open-source project focused on making Pashto (also written as Pukhto/Pushto) a first-class language in speech and language AI.
 
+## Quick Actions
+
+- Search resources: [Pashto Resource Search](search/)
+- Browse all docs: [Documentation Hub](README.md)
+- Browse verified resource catalog: [resource_catalog.md](resource_catalog.md)
+
 ## Mission
 
 - Build open Pashto datasets and resource indexes for ASR, TTS, NLP, and MT.
 - Publish reproducible baseline models, benchmark schemas, and evaluation workflows.
 - Keep progress transparent, contributor-friendly, and public-benefit oriented.
 
-## What Is In This Repository
-
-- `data/`: dataset workflows, metadata, and normalization seeds.
-- `asr/`: ASR baselines and experiment notes.
-- `tts/`: TTS baselines and quality tracking.
-- `benchmarks/`: benchmark schema, result format, and metric guidance.
-- `experiments/`: reproducible run cards and experiment records.
-- `docs/`: policies, roadmap, release process, and operating guides.
-- `resources/`: verified external Pashto datasets, models, tools, benchmarks, and papers.
-
-## Search Pashto Resources
-
-- Search UI: [Pashto Resource Search](search/)
-- 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 References
 
 - Repository: [Musawer1214/pashto-language-resources](https://github.com/Musawer1214/pashto-language-resources)
 - Hugging Face: [Musawer14/pashto-language-resources](https://huggingface.co/Musawer14/pashto-language-resources)
@@ -46,30 +36,24 @@ description: Open-source Pashto (Pukhto/Pashto) datasets, models, benchmarks, AS
 
 ## SEO Operations
 
+- Discoverability playbook: [discoverability_seo.md](discoverability_seo.md)
 - 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
+## Releases
+
+- Release notes index: [releases/README.md](releases/README.md)
+- Current release notes: [v1.0.0](releases/v1.0.0.md)
+- Changelog: [../CHANGELOG.md](../CHANGELOG.md)
+
+## Contribution
 
 You can help by improving documentation, validating normalization rows, sharing verified resources, or contributing data, model, and evaluation workflows.
 
-For contributor workflow and standards, start at:
+Start here:
 - [docs/README.md](README.md)
 - [community/COMMUNICATION.md](../community/COMMUNICATION.md)
 
-## Search Terms
-
-This project is relevant to searches like:
-
-- Pashto datasets
-- Pashto ASR model
-- Pashto TTS resources
-- Pashto NLP benchmark
-- Pashto language technology
-- Pukhto language resources
-
 ## License
 
 This project is released under Apache 2.0. See [LICENSE](../LICENSE).

docs/platform_sync_policy.md

@@ -28,12 +28,19 @@ Use a lowest-common-denominator style in shared docs:
 - 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.
-- Hugging Face may reject binary blobs unless stored with Xet/LFS-compatible flow.
+- Hugging Face may reject binary blobs unless stored with Xet or LFS-compatible flow.
 - Hugging Face may warn about missing model-card metadata in README; this is a warning, not a push blocker.
 
+## Tagging Strategy
+
+- Create annotated tags on GitHub release commits.
+- If Hugging Face rejects a tag because of blocked binary history, create the same tag name on the HF-safe `hf/main` commit.
+- Keep release notes content identical even when commit hashes differ across platforms.
+
 ## Safe Update Checklist
 
 1. Run checks:
@@ -57,4 +64,3 @@ 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

@@ -3,14 +3,19 @@
 Use this checklist before tagging a new release.
 
 ## Required
+
 - [ ] Update [CHANGELOG.md](../CHANGELOG.md).
+- [ ] Add release notes under [releases/README.md](releases/README.md).
 - [ ] Run `python scripts/check_links.py`.
 - [ ] Run `python scripts/validate_normalization.py data/processed/normalization_seed_v0.1.tsv`.
+- [ ] Run `python scripts/validate_resource_catalog.py`.
 - [ ] Confirm benchmark snapshots are stored in [../benchmarks/results/README.md](../benchmarks/results/README.md) format.
 - [ ] Confirm docs reflect the release scope.
 
 ## Recommended
+
 - [ ] 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.
-
+- [ ] Verify GitHub and Hugging Face `main` trees are content-equivalent.
+- [ ] Push release tag to both platforms.

docs/release_process.md

@@ -1,21 +1,32 @@
-# 🚀 Release Process
+# Release Process
 
-## ⏱️ Cadence
-- Monthly milestone release
-- Hotfix releases as needed
+## Cadence
+
+- Scheduled release: monthly milestone or when a major quality threshold is met.
+- Hotfix release: any urgent fixes that should not wait for the next milestone.
+
+## Required for Release
 
-## ✅ Required for release
 - Changelog summary in [../CHANGELOG.md](../CHANGELOG.md)
 - Benchmark snapshot in [../benchmarks/results/README.md](../benchmarks/results/README.md) format
 - Known limitations section in release notes
-- Reproducible commands/scripts
-- Link and normalization checks:
+- Reproducible commands or scripts
+- Validation checks:
   - `python scripts/check_links.py`
   - `python scripts/validate_normalization.py data/processed/normalization_seed_v0.1.tsv`
+  - `python scripts/validate_resource_catalog.py`
+
+## Versioning
+
+- Use semantic version tags: `vMAJOR.MINOR.PATCH`.
+- Example: `v1.0.0`, `v1.0.1`, `v1.1.0`, `v2.0.0`.
+
+## Release Notes Location
+
+- Store release notes in [releases/README.md](releases/README.md).
+- Add one file per release tag under `docs/releases/`.
 
-## 🔖 Versioning
-- Use semantic-style tags for major milestones (e.g., `v0.1`, `v0.2`)
+## Templates
 
-## 🧾 Templates
 - Release checklist: [release_checklist.md](release_checklist.md)
-- Release notes template: [../.github/release_template.md](../.github/release_template.md)
+- Release template: [../.github/release_template.md](../.github/release_template.md)

docs/release_v0.1.1.md

@@ -1,38 +0,0 @@
-# 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

@@ -1,33 +0,0 @@
-# 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)
-

docs/releases/README.md

@@ -0,0 +1,12 @@
+# Releases
+
+This directory stores versioned release notes for the project.
+
+## Current
+
+- [v1.0.0](v1.0.0.md)
+
+## Notes
+
+- `v1.0.0` is the first official stable release tag.
+- Earlier bootstrap history (`v0.1`) remains documented in [../../CHANGELOG.md](../../CHANGELOG.md).

docs/releases/v1.0.0.md

@@ -0,0 +1,33 @@
+# Release Notes: v1.0.0
+
+Release date: 2026-02-18
+Tag: `v1.0.0`
+
+## Summary
+
+First stable release of `pashto-language-resources` with cleaned structure, stronger discoverability, and upgraded web usability for resource exploration.
+
+## Highlights
+
+- Unified release documentation under `docs/releases/`.
+- Removed stale draft release pages and redundant references.
+- Refined docs structure for clearer navigation and lower duplication.
+- Upgraded search page UX with faster exploration patterns and clearer controls.
+- Hardened platform-sync guidance for GitHub and Hugging Face parity.
+
+## Validation
+
+- `python scripts/check_links.py`
+- `python scripts/validate_resource_catalog.py`
+- `python scripts/validate_normalization.py data/processed/normalization_seed_v0.1.tsv`
+- `python -m pytest -q`
+
+## Platform State
+
+- GitHub repository: `Musawer1214/pashto-language-resources`
+- Hugging Face mirror: `Musawer14/pashto-language-resources`
+- Main-branch content is kept equivalent across both platforms.
+
+## Compare
+
+- [GitHub compare: v0.1...v1.0.0](https://github.com/Musawer1214/pashto-language-resources/compare/v0.1...v1.0.0)

docs/search/index.html

@@ -41,79 +41,152 @@ permalink: /search/
   </script>
   <link rel="preconnect" href="https://fonts.googleapis.com">
   <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Sans+Arabic:wght@400;500;700&family=Space+Grotesk:wght@500;700&display=swap" rel="stylesheet">
+  <link href="https://fonts.googleapis.com/css2?family=Manrope:wght@400;600;700;800&family=Noto+Naskh+Arabic:wght@500;700&display=swap" rel="stylesheet">
   <style>
     :root {
-      --bg: #f6f4ec;
-      --panel: #fffef9;
-      --ink: #1d2a24;
-      --muted: #4c6158;
-      --line: #d6ddd7;
-      --brand: #106b53;
-      --brand-soft: #e0f0ea;
-      --accent: #c76a1a;
-      --accent-soft: #f7e9d8;
-      --shadow: 0 12px 30px rgba(29, 42, 36, 0.08);
+      --bg: #f3f2ea;
+      --panel: #fffdf7;
+      --ink: #1d2628;
+      --muted: #55656a;
+      --line: #d5ddd8;
+      --brand: #0f6f61;
+      --brand-soft: #dcf2ee;
+      --accent: #b9621f;
+      --accent-soft: #f8e6d7;
+      --shadow: 0 14px 36px rgba(16, 29, 35, 0.12);
+      --radius-lg: 18px;
+      --radius-md: 12px;
+      --radius-sm: 9px;
     }
 
     * { box-sizing: border-box; }
 
     body {
       margin: 0;
-      font-family: "IBM Plex Sans Arabic", "Segoe UI", sans-serif;
       color: var(--ink);
+      font-family: "Manrope", "Segoe UI", sans-serif;
+      min-height: 100vh;
       background:
-        radial-gradient(circle at 8% 12%, #fce4c4 0, rgba(252, 228, 196, 0) 35%),
-        radial-gradient(circle at 92% 6%, #d8ece5 0, rgba(216, 236, 229, 0) 38%),
+        radial-gradient(circle at 8% 8%, #ffe0bf 0, rgba(255, 224, 191, 0) 30%),
+        radial-gradient(circle at 92% 7%, #d2ece4 0, rgba(210, 236, 228, 0) 35%),
         var(--bg);
-      min-height: 100vh;
     }
 
-    .wrap {
-      max-width: 1100px;
+    a { color: var(--brand); }
+
+    .container {
+      max-width: 1180px;
       margin: 0 auto;
-      padding: 24px 18px 44px;
+      padding: 22px 18px 42px;
     }
 
     .hero {
-      background: linear-gradient(120deg, #fff, #f7fbf9);
+      background: linear-gradient(130deg, #fffef9, #f5faf8);
       border: 1px solid var(--line);
+      border-radius: var(--radius-lg);
       box-shadow: var(--shadow);
-      border-radius: 18px;
-      padding: 20px 18px;
-      margin-bottom: 16px;
-      transform: translateY(8px);
-      opacity: 0;
-      animation: rise 500ms ease forwards;
+      padding: 20px;
+      margin-bottom: 14px;
+    }
+
+    .hero-top {
+      display: flex;
+      justify-content: space-between;
+      align-items: flex-start;
+      gap: 14px;
+      flex-wrap: wrap;
     }
 
     .eyebrow {
-      letter-spacing: 0.07em;
+      margin: 0 0 8px;
+      font-size: 12px;
+      letter-spacing: 0.08em;
       text-transform: uppercase;
       color: var(--accent);
-      font-family: "Space Grotesk", sans-serif;
-      font-weight: 700;
-      font-size: 12px;
-      margin-bottom: 6px;
+      font-weight: 800;
     }
 
     h1 {
-      margin: 0 0 8px;
-      font-family: "Space Grotesk", sans-serif;
-      font-size: 33px;
-      line-height: 1.1;
+      margin: 0;
+      font-size: 34px;
+      line-height: 1.08;
+      letter-spacing: -0.02em;
     }
 
-    .hero p {
-      margin: 0;
+    .subtitle {
+      margin: 10px 0 0;
       color: var(--muted);
-      line-height: 1.5;
+      line-height: 1.55;
+      max-width: 760px;
     }
 
-    .controls {
+    .stat-row {
+      display: grid;
+      grid-template-columns: repeat(3, minmax(120px, 1fr));
+      gap: 8px;
+      width: min(380px, 100%);
+    }
+
+    .stat {
+      border: 1px solid var(--line);
+      border-radius: var(--radius-md);
+      background: var(--panel);
+      padding: 10px;
+      text-align: center;
+    }
+
+    .stat strong {
+      display: block;
+      font-size: 20px;
+      line-height: 1;
+      color: var(--brand);
+    }
+
+    .stat span {
+      display: block;
+      margin-top: 4px;
+      color: var(--muted);
+      font-size: 12px;
+      font-weight: 700;
+      text-transform: uppercase;
+      letter-spacing: 0.04em;
+    }
+
+    .quick-links {
       margin-top: 14px;
+      display: flex;
+      flex-wrap: wrap;
+      gap: 8px;
+    }
+
+    .pill-link {
+      border: 1px solid #b8cec6;
+      border-radius: 999px;
+      background: #f8fcfa;
+      color: var(--brand);
+      text-decoration: none;
+      font-size: 13px;
+      font-weight: 700;
+      padding: 7px 12px;
+    }
+
+    .toolbar {
+      margin-bottom: 12px;
       display: grid;
-      grid-template-columns: 2.2fr 1fr 1fr 1fr 1fr;
+      gap: 12px;
+    }
+
+    .panel {
+      border: 1px solid var(--line);
+      border-radius: var(--radius-lg);
+      background: var(--panel);
+      box-shadow: var(--shadow);
+      padding: 16px;
+    }
+
+    .controls {
+      display: grid;
+      grid-template-columns: 2fr repeat(5, minmax(140px, 1fr));
       gap: 10px;
     }
 
@@ -124,110 +197,158 @@ permalink: /search/
     }
 
     .field label {
-      font-size: 12px;
-      font-weight: 700;
-      color: var(--muted);
-      letter-spacing: 0.04em;
+      font-size: 11px;
+      letter-spacing: 0.05em;
       text-transform: uppercase;
-      font-family: "Space Grotesk", sans-serif;
+      font-weight: 800;
+      color: var(--muted);
     }
 
     input, select {
       width: 100%;
       border: 1px solid var(--line);
-      background: var(--panel);
+      border-radius: var(--radius-sm);
+      background: #fff;
       color: var(--ink);
-      border-radius: 10px;
-      padding: 10px 11px;
+      padding: 10px;
       font: inherit;
     }
 
-    input:focus, select:focus {
-      outline: 2px solid #8cc9b5;
-      border-color: #8cc9b5;
+    input:focus, select:focus, button:focus {
+      outline: 2px solid #7bc7b8;
+      outline-offset: 1px;
+      border-color: #7bc7b8;
     }
 
-    .summary {
-      margin: 14px 2px 6px;
+    .action-row {
+      margin-top: 10px;
       display: flex;
+      flex-wrap: wrap;
       justify-content: space-between;
+      gap: 10px;
       align-items: center;
-      gap: 12px;
-      color: var(--muted);
-      font-size: 14px;
     }
 
-    .badge {
-      background: var(--brand-soft);
-      color: var(--brand);
-      border: 1px solid #b7dccc;
-      padding: 3px 9px;
+    .group {
+      display: flex;
+      flex-wrap: wrap;
+      gap: 7px;
+      align-items: center;
+    }
+
+    .btn {
+      border: 1px solid var(--line);
+      background: #fff;
+      color: var(--ink);
       border-radius: 999px;
-      font-weight: 600;
+      padding: 7px 12px;
+      font-size: 13px;
+      font-weight: 700;
+      cursor: pointer;
     }
 
-    .crawl {
-      margin: 8px 2px 16px;
-      color: var(--muted);
-      font-size: 14px;
-      line-height: 1.5;
+    .btn:hover { border-color: #98b9ae; }
+
+    .btn.brand {
+      background: var(--brand);
+      color: #fff;
+      border-color: var(--brand);
     }
 
-    .crawl p {
-      margin: 6px 0;
+    .btn.light {
+      background: #f6faf8;
+      color: var(--brand);
+      border-color: #b9d8cf;
     }
 
-    .crawl-links {
-      margin: 8px 0 0;
-      padding-left: 18px;
+    .btn.active {
+      background: var(--accent-soft);
+      border-color: #efc08f;
+      color: #915117;
     }
 
-    .crawl-links li {
-      margin: 3px 0;
+    .intent-row {
+      margin-top: 10px;
+      display: flex;
+      flex-wrap: wrap;
+      gap: 7px;
     }
 
-    .grid {
-      display: grid;
-      grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
-      gap: 12px;
+    .intent {
+      border: 1px solid #cfdad4;
+      background: #fbfdfc;
+      border-radius: 999px;
+      padding: 6px 11px;
+      font-size: 13px;
+      font-weight: 700;
+      cursor: pointer;
+      color: var(--muted);
+    }
+
+    .intent:hover { border-color: #9cb8af; color: var(--ink); }
+
+    .summary {
+      margin: 0 2px 12px;
+      display: flex;
+      justify-content: space-between;
+      align-items: center;
+      gap: 10px;
+      color: var(--muted);
+      font-size: 14px;
+    }
+
+    .badge {
+      background: var(--brand-soft);
+      color: var(--brand);
+      border: 1px solid #b7dccc;
+      padding: 4px 9px;
+      border-radius: 999px;
+      font-weight: 700;
+      font-size: 12px;
+    }
+
+    .results {
       list-style: none;
-      padding: 0;
       margin: 0;
+      padding: 0;
+      display: grid;
+      gap: 12px;
     }
 
+    .results.grid { grid-template-columns: repeat(auto-fill, minmax(270px, 1fr)); }
+    .results.list { grid-template-columns: 1fr; }
+
     .card {
       border: 1px solid var(--line);
-      border-radius: 14px;
+      border-radius: var(--radius-md);
       background: var(--panel);
       box-shadow: var(--shadow);
-      padding: 13px 12px;
+      padding: 13px;
       display: flex;
       flex-direction: column;
       gap: 9px;
-      opacity: 0;
-      animation: rise 420ms ease forwards;
+      animation: cardIn 360ms ease;
     }
 
     .chips {
       display: flex;
-      gap: 6px;
       flex-wrap: wrap;
+      gap: 6px;
     }
 
     .chip {
       border-radius: 999px;
-      padding: 2px 8px;
-      font-size: 11px;
-      font-weight: 700;
-      font-family: "Space Grotesk", sans-serif;
-      letter-spacing: 0.03em;
+      font-size: 10px;
+      font-weight: 800;
+      letter-spacing: 0.04em;
       text-transform: uppercase;
+      padding: 3px 8px;
       border: 1px solid transparent;
     }
 
     .chip.category { background: var(--brand-soft); color: var(--brand); border-color: #b7dccc; }
-    .chip.source { background: var(--accent-soft); color: #955016; border-color: #efc89f; }
-    .chip.status { background: #eef3ff; color: #3e4f86; border-color: #d2dbf6; }
+    .chip.source { background: var(--accent-soft); color: #915117; border-color: #efc89f; }
+    .chip.status { background: #edf2ff; color: #3f4f86; border-color: #d0dbf6; }
 
     .title {
       margin: 0;
@@ -241,68 +362,115 @@ permalink: /search/
       border-bottom: 1px solid transparent;
     }
 
-    .title a:hover {
-      border-bottom-color: currentColor;
-    }
+    .title a:hover { border-bottom-color: currentColor; }
 
-    .meta {
+    .text {
+      margin: 0;
       color: var(--muted);
+      line-height: 1.48;
       font-size: 13px;
-      line-height: 1.45;
-      margin: 0;
     }
 
-    .card footer {
+    .meta-links {
       margin-top: auto;
+      display: flex;
+      flex-wrap: wrap;
+      gap: 8px;
+      align-items: center;
+    }
+
+    .mini-link {
+      font-size: 12px;
+      font-weight: 700;
+      color: var(--brand);
+      text-decoration: none;
+    }
+
+    .tasks {
       font-size: 12px;
       color: var(--muted);
+      margin: 0;
     }
 
     .empty {
       border: 1px dashed #b9c4bd;
-      border-radius: 12px;
-      padding: 24px;
+      border-radius: var(--radius-md);
+      padding: 26px;
       background: #fcfcfa;
       color: var(--muted);
       text-align: center;
     }
 
-    @keyframes rise {
-      from { opacity: 0; transform: translateY(8px); }
+    .crawl {
+      margin: 0 2px 12px;
+      color: var(--muted);
+      line-height: 1.5;
+      font-size: 14px;
+    }
+
+    .crawl ul {
+      margin: 8px 0 0;
+      padding-left: 18px;
+    }
+
+    @keyframes cardIn {
+      from { opacity: 0; transform: translateY(5px); }
       to { opacity: 1; transform: translateY(0); }
     }
 
-    @media (max-width: 900px) {
-      .controls {
-        grid-template-columns: 1fr 1fr;
-      }
+    @media (max-width: 1020px) {
+      .controls { grid-template-columns: repeat(3, minmax(140px, 1fr)); }
+      .controls .field.search { grid-column: span 3; }
+    }
 
-      .controls .field:first-child {
-        grid-column: span 2;
-      }
+    @media (max-width: 720px) {
+      h1 { font-size: 30px; }
+      .controls { grid-template-columns: 1fr 1fr; }
+      .controls .field.search { grid-column: span 2; }
+      .summary { flex-direction: column; align-items: flex-start; }
+      .stat-row { width: 100%; }
     }
 
-    @media (max-width: 560px) {
-      h1 { font-size: 28px; }
+    @media (max-width: 520px) {
       .controls { grid-template-columns: 1fr; }
-      .controls .field:first-child { grid-column: span 1; }
-      .summary { flex-direction: column; align-items: flex-start; }
+      .controls .field.search { grid-column: span 1; }
+      h1 { font-size: 28px; }
     }
   </style>
 </head>
 <body>
-  <main class="wrap">
-    <section class="hero">
-      <div class="eyebrow">Pukhto Pashto</div>
-      <h1>Pashto Technology Resource Search</h1>
-      <p>
-        Search and filter verified and candidate resources that support Pashto in ASR, TTS, NLP, translation, tooling, and research.
-      </p>
-
+  <main class="container">
+    <header class="hero">
+      <div class="hero-top">
+        <div>
+          <p class="eyebrow">Pukhto / Pashto Resources</p>
+          <h1>Pashto Technology Resource Search</h1>
+          <p class="subtitle">
+            Filter verified and candidate resources for ASR, TTS, NLP, translation, tools, and benchmark work.
+            Share search states with URL parameters and jump quickly to high-intent pages.
+          </p>
+        </div>
+        <div class="stat-row" aria-label="Catalog metrics">
+          <div class="stat"><strong id="statTotal">-</strong><span>Total</span></div>
+          <div class="stat"><strong id="statVerified">-</strong><span>Verified</span></div>
+          <div class="stat"><strong id="statTasks">-</strong><span>Task Tags</span></div>
+        </div>
+      </div>
+      <nav class="quick-links" aria-label="Quick links">
+        <a class="pill-link" href="../">Docs Home</a>
+        <a class="pill-link" href="../pashto_datasets.md">Datasets Page</a>
+        <a class="pill-link" href="../pashto_asr.md">ASR Page</a>
+        <a class="pill-link" href="../pashto_tts.md">TTS Page</a>
+        <a class="pill-link" href="https://github.com/Musawer1214/pashto-language-resources">GitHub</a>
+        <a class="pill-link" href="https://huggingface.co/Musawer14/pashto-language-resources">Hugging Face</a>
+      </nav>
+    </header>
+
+    <section class="toolbar panel" aria-label="Search controls">
       <div class="controls">
-        <div class="field">
+        <div class="field search">
           <label for="q">Search</label>
-          <input id="q" type="search" placeholder="Try: ASR, pbt_Arab, translation, speech" />
+          <input id="q" type="search" placeholder="Try: asr, pbt_arab, translation, speech, benchmark" autocomplete="off">
         </div>
         <div class="field">
           <label for="category">Category</label>
@@ -320,22 +488,46 @@ permalink: /search/
           <label for="status">Status</label>
           <select id="status"></select>
         </div>
+        <div class="field">
+          <label for="sort">Sort</label>
+          <select id="sort">
+            <option value="relevance">Relevance</option>
+            <option value="title_asc">Title (A-Z)</option>
+            <option value="title_desc">Title (Z-A)</option>
+            <option value="source_asc">Source (A-Z)</option>
+          </select>
+        </div>
+      </div>
+
+      <div class="action-row">
+        <div class="group" role="group" aria-label="Result view mode">
+          <button type="button" class="btn active" id="viewGrid">Grid view</button>
+          <button type="button" class="btn" id="viewList">List view</button>
+        </div>
+        <div class="group">
+          <button type="button" class="btn light" id="clearFilters">Clear filters</button>
+          <button type="button" class="btn brand" id="copyLink">Copy search link</button>
+        </div>
+      </div>
+
+      <div class="intent-row" aria-label="Quick intent filters">
+        <button type="button" class="intent" data-intent="datasets">Datasets</button>
+        <button type="button" class="intent" data-intent="asr">ASR</button>
+        <button type="button" class="intent" data-intent="tts">TTS</button>
+        <button type="button" class="intent" data-intent="nlp">NLP</button>
+        <button type="button" class="intent" data-intent="mt">Translation</button>
+        <button type="button" class="intent" data-intent="verified">Verified only</button>
       </div>
     </section>
 
-    <div class="summary">
+    <div class="summary" aria-live="polite">
       <span id="countText">Loading resources...</span>
       <span class="badge" id="generatedAt">Catalog timestamp: -</span>
     </div>
 
-    <section class="crawl" aria-label="Pashto resource categories">
-      <p>
-        Browse or search resource entries covering Pashto datasets, speech recognition (ASR), text-to-speech (TTS), NLP, translation, tools, and benchmarks.
-      </p>
-      <p>
-        Project overview: <a href="https://github.com/Musawer1214/pashto-language-resources">Musawer1214/pashto-language-resources</a>
-      </p>
-      <ul class="crawl-links">
+    <section class="crawl" aria-label="Resource categories and crawlable links">
+      Browse Pashto resource categories directly:
+      <ul>
         <li><a href="https://github.com/Musawer1214/pashto-language-resources/blob/main/resources/datasets/README.md">Pashto datasets</a></li>
         <li><a href="https://github.com/Musawer1214/pashto-language-resources/blob/main/resources/models/README.md">Pashto models</a></li>
         <li><a href="https://github.com/Musawer1214/pashto-language-resources/blob/main/resources/benchmarks/README.md">Pashto benchmarks</a></li>
@@ -345,16 +537,17 @@ permalink: /search/
     </section>
 
     <noscript>
-      JavaScript is needed for filtering, but the linked category pages above remain accessible.
+      JavaScript is needed for filtering. Category links above remain fully accessible.
     </noscript>
 
-    <ul id="results" class="grid"></ul>
+    <ul id="results" class="results grid"></ul>
   </main>
 
   <script>
     const state = {
       all: [],
-      filtered: []
+      filtered: [],
+      view: "grid"
     };
 
     const els = {
@@ -363,11 +556,29 @@ permalink: /search/
       source: document.getElementById("source"),
       task: document.getElementById("task"),
       status: document.getElementById("status"),
+      sort: document.getElementById("sort"),
       results: document.getElementById("results"),
       countText: document.getElementById("countText"),
-      generatedAt: document.getElementById("generatedAt")
+      generatedAt: document.getElementById("generatedAt"),
+      statTotal: document.getElementById("statTotal"),
+      statVerified: document.getElementById("statVerified"),
+      statTasks: document.getElementById("statTasks"),
+      viewGrid: document.getElementById("viewGrid"),
+      viewList: document.getElementById("viewList"),
+      clearFilters: document.getElementById("clearFilters"),
+      copyLink: document.getElementById("copyLink"),
+      intents: [...document.querySelectorAll(".intent")]
     };
 
+    function esc(value) {
+      return String(value || "")
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&#39;");
+    }
+
     function uniqSorted(values) {
       return [...new Set(values.filter(Boolean))].sort((a, b) => a.localeCompare(b));
     }
@@ -379,13 +590,30 @@ permalink: /search/
       allOption.textContent = allLabel;
       select.appendChild(allOption);
       for (const opt of options) {
-        const el = document.createElement("option");
-        el.value = opt;
-        el.textContent = opt;
-        select.appendChild(el);
+        const entry = document.createElement("option");
+        entry.value = opt;
+        entry.textContent = opt;
+        select.appendChild(entry);
       }
     }
 
+    function updateMetrics() {
+      const verified = state.all.filter((r) => r.status === "verified").length;
+      const tasks = uniqSorted(state.all.flatMap((r) => r.tasks || [])).length;
+      els.statTotal.textContent = String(state.all.length);
+      els.statVerified.textContent = String(verified);
+      els.statTasks.textContent = String(tasks);
+    }
+
+    function setView(view) {
+      state.view = view === "list" ? "list" : "grid";
+      els.results.classList.toggle("grid", state.view === "grid");
+      els.results.classList.toggle("list", state.view === "list");
+      els.viewGrid.classList.toggle("active", state.view === "grid");
+      els.viewList.classList.toggle("active", state.view === "list");
+      syncUrl();
+    }
+
     function matchesQuery(resource, query) {
       if (!query) return true;
       const hay = [
@@ -403,6 +631,26 @@ permalink: /search/
       return hay.includes(query);
     }
 
+    function sortItems(items) {
+      const mode = els.sort.value;
+      const sorted = [...items];
+      if (mode === "title_asc") {
+        sorted.sort((a, b) => (a.title || "").localeCompare(b.title || ""));
+      } else if (mode === "title_desc") {
+        sorted.sort((a, b) => (b.title || "").localeCompare(a.title || ""));
+      } else if (mode === "source_asc") {
+        sorted.sort((a, b) => (a.source || "").localeCompare(b.source || "") || (a.title || "").localeCompare(b.title || ""));
+      } else {
+        sorted.sort((a, b) => {
+          const av = a.status === "verified" ? 0 : 1;
+          const bv = b.status === "verified" ? 0 : 1;
+          if (av !== bv) return av - bv;
+          return (a.title || "").localeCompare(b.title || "");
+        });
+      }
+      return sorted;
+    }
+
     function applyFilters() {
       const q = els.q.value.trim().toLowerCase();
       const category = els.category.value;
@@ -410,20 +658,21 @@ permalink: /search/
       const task = els.task.value;
       const status = els.status.value;
 
-      state.filtered = state.all.filter((resource) => {
+      state.filtered = sortItems(state.all.filter((resource) => {
         if (!matchesQuery(resource, q)) return false;
         if (category && resource.category !== category) return false;
         if (source && resource.source !== source) return false;
         if (status && resource.status !== status) return false;
         if (task && !(resource.tasks || []).includes(task)) return false;
         return true;
-      });
+      }));
 
       renderResults();
+      syncUrl();
     }
 
     function chip(label, cls) {
-      return `<span class="chip ${cls}">${label}</span>`;
+      return `<span class="chip ${cls}">${esc(label)}</span>`;
     }
 
     function renderResults() {
@@ -431,26 +680,104 @@ permalink: /search/
       els.countText.textContent = `${items.length} result${items.length === 1 ? "" : "s"} of ${state.all.length}`;
 
       if (!items.length) {
-        els.results.innerHTML = `<li class="empty">No matches. Try broadening filters or changing keywords.</li>`;
+        els.results.innerHTML = '<li class="empty">No matches. Try broadening filters or clearing one filter at a time.</li>';
         return;
       }
 
-      els.results.innerHTML = items.map((resource, idx) => `
-        <li class="card" style="animation-delay:${Math.min(idx * 28, 320)}ms">
-          <div class="chips">
-            ${chip(resource.category, "category")}
-            ${chip(resource.source, "source")}
-            ${chip(resource.status, "status")}
-          </div>
-          <h2 class="title"><a href="${resource.url}" target="_blank" rel="noreferrer">${resource.title}</a></h2>
-          <p class="meta">${resource.summary}</p>
-          <p class="meta"><strong>Primary use:</strong> ${resource.primary_use}</p>
-          <p class="meta"><strong>Pashto evidence:</strong> <a href="${resource.evidence_url}" target="_blank" rel="noreferrer">${resource.evidence_text}</a></p>
-          <footer>
-            ${(resource.tasks || []).length ? `Tasks: ${resource.tasks.join(", ")}` : "Tasks: n/a"}
-          </footer>
-        </li>
-      `).join("");
+      els.results.innerHTML = items.map((resource) => {
+        const title = esc(resource.title || "Untitled resource");
+        const url = esc(resource.url || "#");
+        const summary = esc(resource.summary || "No summary provided.");
+        const primaryUse = esc(resource.primary_use || "n/a");
+        const evidenceText = esc(resource.evidence_text || "evidence link");
+        const evidenceUrl = esc(resource.evidence_url || resource.url || "#");
+        const tasks = (resource.tasks || []).map((t) => esc(t)).join(", ") || "n/a";
+
+        return `
+          <li class="card">
+            <div class="chips">
+              ${chip(resource.category || "unknown", "category")}
+              ${chip(resource.source || "unknown", "source")}
+              ${chip(resource.status || "unknown", "status")}
+            </div>
+            <h2 class="title"><a href="${url}" target="_blank" rel="noreferrer">${title}</a></h2>
+            <p class="text">${summary}</p>
+            <p class="text"><strong>Primary use:</strong> ${primaryUse}</p>
+            <p class="tasks"><strong>Tasks:</strong> ${tasks}</p>
+            <div class="meta-links">
+              <a class="mini-link" href="${url}" target="_blank" rel="noreferrer">Open resource</a>
+              <a class="mini-link" href="${evidenceUrl}" target="_blank" rel="noreferrer">Pashto evidence: ${evidenceText}</a>
+            </div>
+          </li>
+        `;
+      }).join("");
+    }
+
+    function syncUrl() {
+      const params = new URLSearchParams();
+      if (els.q.value.trim()) params.set("q", els.q.value.trim());
+      if (els.category.value) params.set("category", els.category.value);
+      if (els.source.value) params.set("source", els.source.value);
+      if (els.task.value) params.set("task", els.task.value);
+      if (els.status.value) params.set("status", els.status.value);
+      if (els.sort.value && els.sort.value !== "relevance") params.set("sort", els.sort.value);
+      if (state.view !== "grid") params.set("view", state.view);
+
+      const next = `${window.location.pathname}${params.toString() ? `?${params.toString()}` : ""}`;
+      window.history.replaceState({}, "", next);
+    }
+
+    function applyUrlState() {
+      const params = new URLSearchParams(window.location.search);
+      if (params.get("q")) els.q.value = params.get("q");
+      if (params.get("category")) els.category.value = params.get("category");
+      if (params.get("source")) els.source.value = params.get("source");
+      if (params.get("task")) els.task.value = params.get("task");
+      if (params.get("status")) els.status.value = params.get("status");
+      if (params.get("sort")) els.sort.value = params.get("sort");
+      if (params.get("view")) setView(params.get("view"));
+    }
+
+    function clearFilters() {
+      els.q.value = "";
+      els.category.value = "";
+      els.source.value = "";
+      els.task.value = "";
+      els.status.value = "";
+      els.sort.value = "relevance";
+      setView("grid");
+      applyFilters();
+    }
+
+    function applyIntent(intent) {
+      if (intent === "datasets") {
+        els.category.value = "dataset";
+        els.task.value = "";
+        els.q.value = "";
+      } else if (intent === "asr") {
+        els.task.value = "asr";
+      } else if (intent === "tts") {
+        els.task.value = "tts";
+      } else if (intent === "nlp") {
+        els.task.value = "nlp";
+      } else if (intent === "mt") {
+        els.task.value = "";
+        els.q.value = "translation";
+      } else if (intent === "verified") {
+        els.status.value = "verified";
+      }
+      applyFilters();
+    }
+
+    async function copySearchLink() {
+      try {
+        await navigator.clipboard.writeText(window.location.href);
+        els.copyLink.textContent = "Link copied";
+        setTimeout(() => { els.copyLink.textContent = "Copy search link"; }, 1200);
+      } catch (_error) {
+        els.copyLink.textContent = "Copy failed";
+        setTimeout(() => { els.copyLink.textContent = "Copy search link"; }, 1200);
+      }
     }
 
     async function load() {
@@ -458,37 +785,43 @@ permalink: /search/
         const res = await fetch("./resources.json", { cache: "no-store" });
         if (!res.ok) throw new Error(`HTTP ${res.status}`);
         const payload = await res.json();
+
         state.all = payload.resources || [];
-        state.filtered = [...state.all];
 
         fillSelect(els.category, uniqSorted(state.all.map((r) => r.category)), "All categories");
         fillSelect(els.source, uniqSorted(state.all.map((r) => r.source)), "All sources");
         fillSelect(els.status, uniqSorted(state.all.map((r) => r.status)), "All statuses");
-        fillSelect(
-          els.task,
-          uniqSorted(state.all.flatMap((r) => r.tasks || [])),
-          "All tasks"
-        );
+        fillSelect(els.task, uniqSorted(state.all.flatMap((r) => r.tasks || [])), "All tasks");
+
+        updateMetrics();
 
         const generated = payload.generated_on ? new Date(payload.generated_on) : null;
         els.generatedAt.textContent = generated && !Number.isNaN(generated.getTime())
           ? `Catalog timestamp: ${generated.toISOString()}`
           : "Catalog timestamp: unknown";
 
+        applyUrlState();
         applyFilters();
       } catch (err) {
         els.countText.textContent = "Failed to load resources";
-        els.results.innerHTML = `<li class="empty">Could not load search data. ${String(err)}</li>`;
+        els.results.innerHTML = `<li class="empty">Could not load search data. ${esc(String(err))}</li>`;
       }
     }
 
-    [els.q, els.category, els.source, els.task, els.status].forEach((el) => {
+    [els.q, els.category, els.source, els.task, els.status, els.sort].forEach((el) => {
       el.addEventListener("input", applyFilters);
       el.addEventListener("change", applyFilters);
     });
 
+    els.viewGrid.addEventListener("click", () => setView("grid"));
+    els.viewList.addEventListener("click", () => setView("list"));
+    els.clearFilters.addEventListener("click", clearFilters);
+    els.copyLink.addEventListener("click", copySearchLink);
+    els.intents.forEach((button) => {
+      button.addEventListener("click", () => applyIntent(button.dataset.intent));
+    });
+
     load();
   </script>
 </body>
 </html>
-

pyproject.toml

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