docs: add TL;DR, FAQ, and GEO enhancements for discoverability

[Aliserag]

Summary

• Add TL;DR block under H1 with What/Who/Why/Status/License/Related-repos bullets
• Add FAQ section with answers grounded in existing README content
• Add Community and About Flow footer sections
• Fix deprecated docs.onflow.org URLs → developers.flow.com / cadence-lang.org
• Add CITATION.cff and CHANGELOG.md stubs
• Brand voice fixes (no "Flow blockchain", no "Flow's" possessive)

Test plan

• Review README.md diff for accuracy and brand voice compliance
• Verify all links resolve
• Confirm no SEO_AUDIT_REPORT.md or .audit-extract.json in commit

Summary by CodeRabbit

• Documentation
  • Added CHANGELOG directing users to GitHub Releases for official version history and release notes.
  • Added CITATION.cff with citation metadata for academic and research reference.
  • Revised README with new badges, a TL;DR project summary, expanded FAQ (overview, node roles, Go version, local network setup, security reporting), and an About Flow section with external links.

[github-actions]

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: f6039fc7-bee8-4968-884c-892cc13c241a

📥 Commits

Reviewing files that changed from the base of the PR and between e2a8f4f and 2b8cad7.

📒 Files selected for processing (3)

• CHANGELOG.md
• CITATION.cff
• README.md

✅ Files skipped from review due to trivial changes (2)

• CHANGELOG.md
• CITATION.cff

🚧 Files skipped from review as they are similar to previous changes (1)

• README.md

---

📝 Walkthrough

Walkthrough

This PR adds documentation and metadata: a new CHANGELOG.md pointing to GitHub Releases, a CITATION.cff with citation metadata, and an expanded README.md with badges, a TL;DR, FAQ, and project context updates.

Changes

Cohort / File(s)	Summary
Metadata & Documentation CHANGELOG.md, CITATION.cff, README.md	Added CHANGELOG.md redirecting to GitHub Releases; introduced CITATION.cff containing citation metadata (AGPL-3.0-only, authors, keywords); expanded README.md with badges, TL;DR, FAQ (node roles, Go version, Cadence relation, security reporting), and "About Flow" links.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Poem

🐰 Badges shining, changelogs in tow,
Citations tidy, README in a row,
Docs nibble forward, small hops, not slow,
A rabbit cheers—let flow-go grow! 🥕✨

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the main changes: adding TL;DR and FAQ sections to README.md, plus improving discoverability through documentation enhancements and metadata files (CITATION.cff, CHANGELOG.md).
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch seo-geo-audit-2026-04-21

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[codecov-commenter]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[coderabbitai]

🧹 Nitpick comments (1)

README.md (1)

24-37: Table of Contents is stale after adding new sections.

FAQ and About Flow are missing from the TOC, so navigation is incomplete. Please re-run doctoc so anchors match current headings.

🤖 Prompt for AI Agents

Verify each finding against the current code and only fix it if needed.

In `@README.md` around lines 24 - 37, The Table of Contents is out of date: re-run
doctoc (or your TOC generator) to regenerate the anchors so the README TOC
includes the newly added headings "FAQ" and "About Flow"; update the TOC block
between the doctoc markers to include those entries and ensure their anchor
slugs match the actual headings in the document (e.g., "FAQ" and "About Flow")
so navigation works correctly.

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Nitpick comments:
In `@README.md`:
- Around line 24-37: The Table of Contents is out of date: re-run doctoc (or
your TOC generator) to regenerate the anchors so the README TOC includes the
newly added headings "FAQ" and "About Flow"; update the TOC block between the
doctoc markers to include those entries and ensure their anchor slugs match the
actual headings in the document (e.g., "FAQ" and "About Flow") so navigation
works correctly.

---

ℹ️ Review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 12758565-2c1c-4715-a4a9-bef98b3fd1b1

📥 Commits

Reviewing files that changed from the base of the PR and between a469a19 and e2a8f4f.

📒 Files selected for processing (3)

• CHANGELOG.md
• CITATION.cff
• README.md