Skip to content

Add GitHub Pages site for foragent.dev; refresh README for alpha status#15

Merged
rockfordlhotka merged 2 commits intomainfrom
docs/github-pages-site
Apr 23, 2026
Merged

Add GitHub Pages site for foragent.dev; refresh README for alpha status#15
rockfordlhotka merged 2 commits intomainfrom
docs/github-pages-site

Conversation

@rockfordlhotka
Copy link
Copy Markdown
Member

Summary

  • Adds a GitHub Pages landing page under /docs/ aimed at first-time arrivals to foragent.dev: purpose, usage scenarios, quick start, and links to the spec / architecture / capabilities / credentials docs plus the issues tracker.
  • Uses the built-in jekyll-theme-cayman (no plugins, no Actions build — plain "Deploy from branch, /docs folder" source). _config.yml excludes archive/, framework-feedback.md, and README.md from the rendered site so the public surface stays focused.
  • Pins the custom domain via docs/CNAME = foragent.dev.
  • Refreshes README.md to reflect current reality: v0.2 has shipped end-to-end (milestone 9), so the "not yet functional" warning is replaced with an alpha-quality status. Adds a docker-compose quick start, an advertised-capabilities list, and links to the documentation set and the live site.

Follow-up (manual, not part of this PR)

After merge, on the repo:

  1. Settings → Pages → Source = Deploy from a branch, branch = main, folder = /docs. Save.
  2. Settings → Pages → Custom domainforagent.dev. Save. Tick Enforce HTTPS once the Let's Encrypt cert provisions.
  3. One-time domain verification at github.com/settings/pages (TXT record) to prevent takeover.
  4. DNS at the registrar: four A records to 185.199.108–111.153, four AAAA records to 2606:50c0:8000–8003::153, and CNAME www → marimerllc.github.io.

Test plan

  • PR preview renders the landing page without layout glitches
  • All in-site links (/foragent-specification, /architecture, /capabilities, /credentials) resolve once Pages is enabled
  • External links (GitHub repo, issues, RockBot, LICENSE, CONTRIBUTING) all resolve
  • README still reads cleanly on the GitHub repo front page

🤖 Generated with Claude Code

rockfordlhotka and others added 2 commits April 23, 2026 14:56
- /docs/index.md landing page: purpose, scenarios, quick start, resource links, contributing
- /docs/_config.yml Jekyll config (cayman theme, excludes archive/framework-feedback/README)
- /docs/CNAME pins custom domain to foragent.dev
- README: drop "not yet functional" warning (v0.2 has shipped), expand capabilities list,
  add docker-compose quick start, link to foragent.dev and docs/

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@rockfordlhotka rockfordlhotka merged commit fff964c into main Apr 23, 2026
1 check passed
@rockfordlhotka rockfordlhotka deleted the docs/github-pages-site branch April 23, 2026 20:14
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