Live site: https://affordact.com
Repo: https://github.com/cFerg/Affordability-Act

This repo hosts a public, version-controlled copy of the Affordability Act text and the website that renders it.

• Full bill: /policy/bill-text/
• Individual sections: /policy/sections/<name>.md → browsable on the website

• Best: Open a GitHub Issue with your suggestion/correction:
  https://github.com/cFerg/Affordability-Act/issues/new/choose
• Discussion: https://github.com/cFerg/Affordability-Act/discussions
• No GitHub? Use the form: https://affordact.com/submit/

Please avoid editing the compiled policy/bill-text.md directly — it’s generated. Edit files under policy/sections/ instead.

policy/
  sections/            # <— Edit these .md files (one per section)
  bill-text.md         # <— Generated by tools/build_docs.py; Not manually edited.
assets/                # CSS, JS, icons, images (OG image, webmanifest, etc.)
tools/
  build_docs.py        # Merges the sections -> bill-text.md (Excludes section page info)
.github/workflows/
  pages.yml            # Builds and deploys the site (GitHub Pages)
  gen_icons.yml        # Optional: renders PNG/ICO from assets/favicon.svg
_config.yml            # Jekyll config (Used for website styling)
index.md               # Landing page (home)
submit.md              # Public feedback form (Used for individuals without github accounts)
sections.json          # Order of sections (manual or generated)
_data/sections.json    # Optional mirror of sections.json for server-side index

• policy/bill-text.md (Generated via Build_Docs.py)
• .github/workflows (Unless you know CI)
• assets/favicon.*, assets/icon-*.png, assets/site.webmanifest (Auto-Rendered via SVGs)

You can run the site locally to check layout or content changes before pushing.

1. Install Ruby and Jekyll — or open this repo in GitHub Codespaces (which already has them).
2. In your terminal, run the following:

bundle install
bundle exec jekyll serve

3. This will build the site and serve it locally.
4. Open the preview in your browser at http://127.0.0.1:4000
5. Edit files under policy/sections/, then refresh the page to see updates.