OpenGov summary: Difference between revisions

3,267 bytes added ,  Thursday at 00:33
Line 182: Line 182:


=== Always defers to originals ===
=== Always defers to originals ===
* Every page features prominent, USWDS-styled elements:
OpenGov Encyclopedia is built on the principle that it is never the authoritative source. Every page explicitly directs users back to the original federal .gov site(s) for verification, actions, applications, or any official purpose. This respects agency ownership, prevents confusion or duplication, and builds citizen trust through transparency.
* Top banner: "Supplemental context and relationships only. This is not the official record."
* Direct link: "Official source of truth: [Primary .gov URL] — complete actions and verify details there."
* Action buttons: "Apply / Learn More / Take Action →" pointing exclusively to agency/USA.gov sites.
* Footer: "Dual-AI verified from official sources • [timestamp] • Confidence: [score] • Always check primary .gov for authoritative information."
* This design builds citizen trust, avoids any perception of competition, and funnels users to primary federal destinations.


Every page incorporates clear, consistent, USWDS-styled elements that are impossible to miss. These use proven patterns like alerts for notices and footers for reassurance, adapted to MediaWiki's capabilities:
==== Top banner (prominent notice) ====
* A high-visibility alert-style box appears at the top of every page. 
* Text:  This material is provided for background context and relationships only and is not the official record.
* Styled using a custom MediaWiki template with USWDS-inspired classes (added via modified skin CSS in MediaWiki:Common.css or the USWDS-integrated skin file). Includes ARIA attributes for accessibility (role="status" or role="region" with aria-label).
==== Direct source link ====
* Placed immediately below the banner or integrated into the Cargo infobox/header. 
* Text: Official source of truth: [Primary .gov URL] — complete actions and verify details there.
* Rendered as a large, clickable USWDS-style button or link (e.g., usa-button usa-button--primary). Multiple sources are listed cleanly if applicable.
==== Action buttons ====
  Every relevant section ends with directive buttons: 
  - **Apply Now →** 
  - **Learn More / Eligibility Details →** 
  - **Take Action / Submit Application →** 
  Styled as USWDS usa-button (primary or outline variants). All point exclusively to the official agency site, USA.gov task page, or form endpoint—no internal completion paths.
==== Footer ====
(persistent reassurance with dynamic Cargo data)
  At the bottom of every page, styled in the USWDS identifier/footer pattern. 
  Uses a Cargo-powered template to display live, queryable metadata: 
  **Dual-AI verified from official sources • Last verified: [timestamp from Cargo field] • Confidence: [score from Cargo field, e.g., 98%] • Always check primary .gov for authoritative information.** 
  Cargo integration: 
  Verification fields (e.g., LastVerified=Date, Confidence=Float) are declared in the Cargo table. The footer template queries the current page’s data (using |where=_pageName={{PAGENAME}}) to populate values dynamically. 
  This enables site-wide queries, such as sorting articles by verification date or confidence rating: 
  ```wikitext
{{#cargo_query:
  tables=VerificationMetadata
  |fields=Page=Page, LastVerified=Last Verified, Confidence=Confidence
  |order by=LastVerified DESC
  |limit=50
  }}
  ``` 
  (Can be embedded on a dashboard or oversight page.)
All elements are automatic (baked into page templates and skin), consistent across the site, and meet WCAG 2.1 AA / Section 508 standards (high-contrast, keyboard-navigable, ARIA roles).
This design turns a potential concern into a strength.  - Citizens see plain-English, repeated messaging that makes the supplemental role crystal clear from the first second.  - Agencies retain full ownership: OpenGov Encyclopedia never competes—it acts as a helpful map that sends users straight to the right .gov destination, better informed and ready to act.  - Traffic funnels to primary sites: Prominent, task-oriented buttons improve completion rates on official pages.  - Trust is reinforced: Dynamic verification details in the footer show real-time quality (timestamp + confidence score), while the Cargo backend allows easy auditing and reporting on freshness and accuracy across thousands of pages.
In short, OpenGov Encyclopedia enhances discovery and understanding while always honoring the single source of truth on the original .gov—exactly what citizens and agencies need in an AI-powered era.
== Truth layer ==
== Truth layer ==
OpenGov Encyclopedia would serve as the authoritative ground truth layer the federal government needs to feed clean, structured data into the dozens of agency LLMs and chatbots that are currently hallucinating on messy websites and PDF archives.
OpenGov Encyclopedia would serve as the authoritative ground truth layer the federal government needs to feed clean, structured data into the dozens of agency LLMs and chatbots that are currently hallucinating on messy websites and PDF archives.