Skip to content

Refocus README + unify documentation polish with Hack23 ecosystem SEO#2072

Merged
pethers merged 6 commits intomainfrom
copilot/update-readme-political-intelligence
Apr 27, 2026
Merged

Refocus README + unify documentation polish with Hack23 ecosystem SEO#2072
pethers merged 6 commits intomainfrom
copilot/update-readme-political-intelligence

Conversation

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 27, 2026 •
edited
Loading

Plan: README rewrite + complete documentation polish & Hack23 ecosystem SEO

Phase 1 — README rewrite (✅ done)

  • Refocus around political intelligence · transparency · AI news (3-pass AI-FIRST)

Phase 2 — Documentation polish (✅ done)

  • Header polish on 6 bare docs (centered-banner pattern)
  • Unified 🔗 Hack23 Ecosystem footer added to 13 most important docs

Phase 3 — Extend SEO footer to entire portfolio (✅ done)

  • Footer appended to remaining 19 architecture / governance / FUTURE_* docs

Phase 4 — Address PR review comments (✅ done)

  • README.md — corrected "Four flagship pages" → "Five" (table actually has 5 rows incl. Sitemap)
  • All 32 docs — stripped non-functional <a href="#"> wrappers around decorative shields.io badges (per @copilot-pull-request-reviewer feedback on TESTING.md:13-16 — applies repo-wide for keyboard-user accessibility and link-checker hygiene)

Final result

  • All 33 root markdown files share consistent visual identity, link uniformly into the Hack23 ecosystem, and contain zero broken/placeholder anchors
  • Footer badges retain their real targets (OpenSSF Best Practices, OpenSSF Scorecard, ISMS-PUBLIC, Apache 2.0) — only the decorative metadata badges in headers were unwrapped

Copilot AI and others added 4 commits April 27, 2026 22:27
@pethers
Complete README rewrite focused on political intelligence, transparen…
25b4c06 
…cy, democracy & AI-generated news

Agent-Logs-Url: https://github.com/Hack23/riksdagsmonitor/sessions/0778e8dd-4b6f-45ce-a250-7ac12712a4ec

Co-authored-by: pethers <1726836+pethers@users.noreply.github.com>
@pethers
readme: improve scannability of platform table and intro per code review
964eda5 
Agent-Logs-Url: https://github.com/Hack23/riksdagsmonitor/sessions/0778e8dd-4b6f-45ce-a250-7ac12712a4ec

Co-authored-by: pethers <1726836+pethers@users.noreply.github.com>
@pethers
docs: polish 6 bare docs and add Hack23 ecosystem SEO footer to 13 ke…
f182ce2 
…y docs

Agent-Logs-Url: https://github.com/Hack23/riksdagsmonitor/sessions/cc4d9450-abd4-4df8-9e32-7f9c7e9a21c1

Co-authored-by: pethers <1726836+pethers@users.noreply.github.com>
@pethers
docs: extend Hack23 ecosystem SEO footer to all architecture portfoli…
5dd8590 
…o docs (19 more)

Agent-Logs-Url: https://github.com/Hack23/riksdagsmonitor/sessions/fcf6fb5d-0c80-41e1-861b-641bf0b566ce

Co-authored-by: pethers <1726836+pethers@users.noreply.github.com>
@github-actions github-actions Bot added documentation Documentation updates security Security improvements i18n Internationalization/localization translation Translation updates isms ISMS compliance changes iso-27001 ISO 27001 controls nist-csf NIST CSF compliance cis-controls CIS Controls skill Skill configuration agent Agent configuration size-xl Extra large change (> 1000 lines) labels Apr 27, 2026
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 27, 2026

🏷️ Automatic Labeling Summary

This PR has been automatically labeled based on the files changed and PR metadata.

Applied Labels: documentation,security,i18n,translation,isms,iso-27001,nist-csf,cis-controls,skill,size-xl,agent

Label Categories

  • 🗳️ Content: news, dashboard, visualization, intelligence
  • 💻 Technology: html-css, javascript, workflow, security
  • 📊 Data: cia-data, riksdag-data, data-pipeline, schema
  • 🌍 I18n: i18n, translation, rtl
  • 🔒 ISMS: isms, iso-27001, nist-csf, cis-controls
  • 🏗️ Infrastructure: ci-cd, deployment, performance, monitoring
  • 🔄 Quality: testing, accessibility, documentation, refactor
  • 🤖 AI: agent, skill, agentic-workflow

For more information, see .github/labeler.yml.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 27, 2026

🔍 Lighthouse Performance Audit

Category Score Status
Performance 85/100 🟡
Accessibility 95/100 🟢
Best Practices 90/100 🟢
SEO 95/100 🟢

📥 Download full Lighthouse report

Budget Compliance: Performance budgets enforced via budget.json

@pethers pethers marked this pull request as ready for review April 27, 2026 23:05
Copilot AI review requested due to automatic review settings April 27, 2026 23:05
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 27, 2026

🔍 Lighthouse Performance Audit

Category Score Status
Performance 85/100 🟡
Accessibility 95/100 🟢
Best Practices 90/100 🟢
SEO 95/100 🟢

📥 Download full Lighthouse report

Budget Compliance: Performance budgets enforced via budget.json

Copilot AI reviewed Apr 27, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

This PR standardizes the repository’s root documentation presentation and improves cross-linking for ecosystem SEO, while refocusing the root README around platform discoverability and autonomous newsroom capabilities.

Changes:

  • Refactors README.md to a shorter, more platform-focused structure with updated links, metrics, and navigation.
  • Introduces consistent “centered-banner” headers for several previously plain docs.
  • Appends a unified “Hack23 Ecosystem” footer across root documentation files.

Reviewed changes

Copilot reviewed 32 out of 33 changed files in this pull request and generated 2 comments.

Show a summary per file
File Description
WORKFLOWS.md Appends standardized Hack23 Ecosystem footer for cross-linking/SEO consistency.
TRANSLATION_GUIDE.md Adds centered-banner header and appends Hack23 Ecosystem footer.
THREAT_MODEL.md Appends standardized Hack23 Ecosystem footer.
TESTING.md Adds centered-banner header and appends Hack23 Ecosystem footer.
SWOT.md Appends standardized Hack23 Ecosystem footer.
STATEDIAGRAM.md Appends standardized Hack23 Ecosystem footer.
SKILLS.md Adds centered-banner header and appends Hack23 Ecosystem footer.
SECURITY_ARCHITECTURE.md Appends standardized Hack23 Ecosystem footer.
SECURITY.md Appends standardized Hack23 Ecosystem footer.
RELEASE_PROCESS.md Adds centered-banner header and appends Hack23 Ecosystem footer.
README.md Refocuses README structure/content and updates key links and platform navigation.
MINDMAP.md Appends standardized Hack23 Ecosystem footer.
LABELS.md Adds centered-banner header and appends Hack23 Ecosystem footer.
FinancialSecurityPlan.md Appends standardized Hack23 Ecosystem footer.
FUTURE_WORKFLOWS.md Appends standardized Hack23 Ecosystem footer.
FUTURE_THREAT_MODEL.md Appends standardized Hack23 Ecosystem footer.
FUTURE_SWOT.md Appends standardized Hack23 Ecosystem footer.
FUTURE_STATEDIAGRAM.md Appends standardized Hack23 Ecosystem footer.
FUTURE_SECURITY_ARCHITECTURE.md Appends standardized Hack23 Ecosystem footer.
FUTURE_MINDMAP.md Appends standardized Hack23 Ecosystem footer.
FUTURE_FLOWCHART.md Appends standardized Hack23 Ecosystem footer.
FUTURE_DATA_MODEL.md Appends standardized Hack23 Ecosystem footer.
FUTURE_ARCHITECTURE.md Appends standardized Hack23 Ecosystem footer.
FLOWCHART.md Appends standardized Hack23 Ecosystem footer.
End-of-Life-Strategy.md Appends standardized Hack23 Ecosystem footer.
DATA_MODEL.md Appends standardized Hack23 Ecosystem footer.
CRA-ASSESSMENT.md Appends standardized Hack23 Ecosystem footer.
CONTRIBUTING.md Appends standardized Hack23 Ecosystem footer.
CODE_OF_CONDUCT.md Appends standardized Hack23 Ecosystem footer.
BCPPlan.md Appends standardized Hack23 Ecosystem footer.
Article-Generation.md Appends standardized Hack23 Ecosystem footer.
ARCHITECTURE.md Appends standardized Hack23 Ecosystem footer.
AGENTS.md Adds centered-banner header and appends Hack23 Ecosystem footer.
Comments suppressed due to low confidence (2)

TRANSLATION_GUIDE.md:1

  • Org.nr formatting is inconsistent across the repo/docs (sometimes 5595347807, sometimes 559534-7807). For legal identifiers, it’s best to standardize on one canonical representation across all documents (including headers and footers) to avoid ambiguity and accidental drift.
    WORKFLOWS.md:1
  • The ecosystem footer appears to be copy-pasted verbatim across many root docs. That makes future updates (URLs, badges, policy links, org metadata) error-prone and increases the risk of docs drifting out of sync. Consider introducing a single source-of-truth template (e.g., docs/_fragments/hack23-ecosystem-footer.md) plus a small sync script and/or CI check that enforces identical footer content across files; this preserves the SEO benefit while keeping edits centralized.

Comment thread README.md
Comment on lines +82 to +90
## 🌐 Explore the Platform

### 📋 Data Classification Levels
Four flagship pages anchor the public site. Each is **multilingual (14 languages)**, **WCAG 2.1 AA accessible**, **SEO-optimised** with JSON-LD structured data and `hreflang` alternates, and **CSP-hardened** with Subresource Integrity (SRI) on every CDN asset.

For operational data handling, we use a simplified 4-level scheme:
<table>
<thead>
<tr><th width="80" align="center">Icon</th><th>Page</th><th>What it does</th></tr>
</thead>
<tbody>
Copy link

Copilot AI Apr 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section says “Four flagship pages” but the table that follows includes more than four entries (e.g., it also lists a Sitemap). Please align the prose with the actual number of rows (update the count, or remove/relocate the extra row) to avoid confusing readers.

Copilot uses AI. Check for mistakes.
Comment thread TESTING.md Outdated
Comment on lines +13 to +16
<a href="#"><img src="https://img.shields.io/badge/Owner-CEO-0A66C2?style=for-the-badge" alt="Owner"/></a>
<a href="#"><img src="https://img.shields.io/badge/Version-1.0-555?style=for-the-badge" alt="Version"/></a>
<a href="#"><img src="https://img.shields.io/badge/Coverage-70%25_lines-brightgreen?style=for-the-badge" alt="Coverage"/></a>
<a href="#"><img src="https://img.shields.io/badge/WCAG-2.1_AA-purple?style=for-the-badge" alt="WCAG 2.1 AA"/></a>
Copy link

Copilot AI Apr 27, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The badges are wrapped in links with href=\"#\", which creates non-functional links and can be confusing for keyboard users and automated link checking. Prefer either (a) removing the surrounding <a> entirely if the badge isn’t meant to link anywhere, or (b) linking to a real target (e.g., an internal anchor/section, a policy document, or a GitHub profile/org page).

Suggested change
<a href="#"><img src="https://img.shields.io/badge/Owner-CEO-0A66C2?style=for-the-badge" alt="Owner"/></a>
<a href="#"><img src="https://img.shields.io/badge/Version-1.0-555?style=for-the-badge" alt="Version"/></a>
<a href="#"><img src="https://img.shields.io/badge/Coverage-70%25_lines-brightgreen?style=for-the-badge" alt="Coverage"/></a>
<a href="#"><img src="https://img.shields.io/badge/WCAG-2.1_AA-purple?style=for-the-badge" alt="WCAG 2.1 AA"/></a>
<img src="https://img.shields.io/badge/Owner-CEO-0A66C2?style=for-the-badge" alt="Owner"/>
<img src="https://img.shields.io/badge/Version-1.0-555?style=for-the-badge" alt="Version"/>
<img src="https://img.shields.io/badge/Coverage-70%25_lines-brightgreen?style=for-the-badge" alt="Coverage"/>
<img src="https://img.shields.io/badge/WCAG-2.1_AA-purple?style=for-the-badge" alt="WCAG 2.1 AA"/>

Copilot uses AI. Check for mistakes.
@pethers
Copy link
Copy Markdown
Member

pethers commented Apr 27, 2026

@copilot apply changes based on the comments in this thread

Copy link
Copy Markdown
Contributor Author

Copilot AI commented Apr 27, 2026

@copilot apply changes based on the comments in this thread

Both reviewer points addressed in 17e0aca:

  1. README.md:82 — corrected "Four flagship pages" → "Five" to match the 5-row table (including the Sitemap entry).
  2. TESTING.md:13-16 (and applied repo-wide for consistency) — stripped the non-functional <a href="#"> wrappers from decorative shields.io metadata badges across all 32 affected docs. Footer badges that link to real targets (OpenSSF Best Practices, OpenSSF Scorecard, ISMS-PUBLIC, Apache 2.0) were untouched. Zero href="#" anchors remain in any root .md file.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 27, 2026

🔍 Lighthouse Performance Audit

Category Score Status
Performance 85/100 🟡
Accessibility 95/100 🟢
Best Practices 90/100 🟢
SEO 95/100 🟢

📥 Download full Lighthouse report

Budget Compliance: Performance budgets enforced via budget.json

Copilot AI requested a review from pethers April 27, 2026 23:19
@pethers pethers merged commit 2cef177 into main Apr 27, 2026
12 checks passed
@pethers pethers deleted the copilot/update-readme-political-intelligence branch April 27, 2026 23:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

@pethers pethers Awaiting requested review from pethers

Assignees

@pethers pethers

Copilot code review Copilot

Labels

agent Agent configuration cis-controls CIS Controls documentation Documentation updates i18n Internationalization/localization isms ISMS compliance changes iso-27001 ISO 27001 controls nist-csf NIST CSF compliance security Security improvements size-xl Extra large change (> 1000 lines) skill Skill configuration translation Translation updates

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@pethers