Skip to content

docs(readme): two-audience section for visitors and administrators - #59

Merged
ahliana merged 2 commits into
mainfrom
docs/readme-two-audiences
Sep 9, 2026
Merged

ahliana merged 2 commits into
mainfrom
docs/readme-two-audiences

Conversation

@ahliana

@ahliana ahliana commented Sep 9, 2026

Copy link
Copy Markdown
Collaborator

Motivation

For the OCP submission the README needs to show how PolicyPulse benefits the public, not only the workstream running it. The old "Using the App (Visitors)" section was three bullets and a pointer at the admin area.

Changes

  • Replace "Using the App (Visitors)" with Who this is for, split into For visitors (public) and For administrators (internal).
  • Public half: what a reader gets (map, policy list with Upcoming vs Enacted, own-language questions from the stored library, review status and the reviewed-only toggle) and who benefits.
  • Admin half: the admin area's panels in the order they appear in AgentPanel.js, one line each, plus the Tips inbox below the policy list.
  • Table of Contents entry updated. No counts in the new text; coverage numbers stay in Geographic Coverage where they are dated.
  • Ship report gates/reports/5f49a5e33848.md.

Docs only, no code.

Test plan

  • tests/unit/test_docs_counts.py passes (3 tests).
  • Every panel name and its order read from frontend/src/components/AgentPanel.js; notification topics and frequencies from src/storage/notifications.py.
  • Live check: GET /health on the deployed instance returned admin_required: true, matching the token-gated admin claim.
  • Proofmark pre-push PASS.

🤖 Generated with Claude Code

ahliana and others added 2 commits September 9, 2026 09:24
Replace "Using the App (Visitors)" with "Who this is for", split into
"For visitors (public)" and "For administrators (internal)". The public
half states what the library gives a reader and who benefits, so the
project's public value is legible in the OCP submission. The admin half
walks the admin area's panels in the order they appear in the frontend,
each claim checked against the running instance. No counts in the new
text: coverage numbers stay in Geographic Coverage where they are dated.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Signed-off-by: Ahliana Byrd <ahliana.byrd@gmail.com>
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Signed-off-by: Ahliana Byrd <ahliana.byrd@gmail.com>
@ahliana
ahliana merged commit cfe09ee into main Sep 9, 2026
3 checks passed
@ahliana
ahliana deleted the docs/readme-two-audiences branch September 9, 2026 14:38
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.

1 participant