docs: document Forgejo and Gitea setup

[mariusvniekerk]

Describe public and self-hosted Forgejo/Gitea configuration, provider-host token lookup, minimum read scopes, and the platform invariants that keep identity and capability boundaries provider-scoped.

[mariusvniekerk]

This change is part of the following stack:

• docs: plan Forgejo provider implementation #265
  • feat: add Forgejo and Gitea SDK client skeletons #267
    • feat: share Forgejo and Gitea provider core #268
      • feat: convert Forgejo and Gitea SDK records #269
        • feat: read Forgejo and Gitea through shared provider core #270
          • feat: start Forgejo and Gitea providers at runtime #271
            • feat: recognize Forgejo and Gitea provider configuration #266
              • test: cover Forgejo and Gitea repository imports #272
                • feat: expose Forgejo and Gitea repository imports #273
                  • test: add Forgejo and Gitea container fixtures #274
                  • feat: enable proven Forgejo and Gitea mutations #275
                  • docs: document Forgejo and Gitea setup #276 ◀
                  • feat: add gitealike Actions CI parity #281

_{Change managed by git-spice.}

[roborev-ci]

roborev: Combined Review (14594e7)

No Medium, High, or Critical issues found.

All review agents reported the documentation and example config changes as clean.

---

Synthesized from 3 reviews (agents: codex, gemini | types: default, security)

[roborev-ci]

roborev: Combined Review (5055362)

No Medium, High, or Critical findings; the reviewed changes look clean.

All agents reported no issues.

---

Synthesized from 3 reviews (agents: codex, gemini | types: default, security)

[roborev-ci]

roborev: Combined Review (92b1b40)

Medium issue found; no high or critical findings.

Medium

• internal/platform/gitea/read.go:298 - Gitea Actions reads are enabled for every Gitea client, but ListActionRuns only falls back for SDK version-constraint errors. If a host is 1.26+ but Actions is disabled or the /actions/runs route is unavailable, a 404/405/501 can fail the whole CI refresh even though commit statuses were already readable.

  Suggested fix: Treat unsupported Actions endpoint responses as empty action-run results after statuses succeed, or gate ReadActions per host after probing support. Keep permission/auth failures fatal.

---

Synthesized from 3 reviews (agents: codex, gemini | types: default, security)

[roborev-ci]

roborev: Combined Review (3d5626d)

No Medium, High, or Critical issues found.

All review agents reported no actionable findings for this diff.

---

Synthesized from 3 reviews (agents: codex, gemini | types: default, security)

[roborev-ci]

roborev: Combined Review (3f98a70)

Verdict: No Medium, High, or Critical issues were reported.

All available review outputs are clean; no actionable findings to include.

---

Synthesized from 3 reviews (agents: codex, gemini | types: default, security)

[roborev-ci]

roborev: Combined Review (a7ccb27)

No Medium, High, or Critical findings were reported.

All review agents that provided findings agree the diff is clean; the only substantive review notes that these are documentation-only changes with no runtime, dependency, CI, or executable-code impact.

---

Synthesized from 3 reviews (agents: codex, gemini | types: default, security)

[roborev-ci]

roborev: Combined Review (6e9bf03)

No Medium, High, or Critical findings were reported.

All reviewed agents that provided findings found the diff clean.

---

Synthesized from 3 reviews (agents: codex, gemini | types: default, security)

[roborev-ci]

roborev: Combined Review (261f909)

No Medium, High, or Critical issues found.

All reviewers agreed the changes are documentation-only and reported no findings.

---

Synthesized from 3 reviews (agents: codex, gemini | types: default, security)

[roborev-ci]

roborev: Combined Review (74198e0)

No Medium, High, or Critical findings were reported.

All review agents found the documentation-only changes clean.

---

Synthesized from 3 reviews (agents: codex, gemini | types: default, security)

[roborev-ci]

roborev: Combined Review (74198e0)

No medium-or-higher findings were reported; the reviewed changes look clean.

All agents that reported results found no issues.

---

Synthesized from 3 reviews (agents: codex, gemini | types: default, security)

[roborev-ci]

roborev: Combined Review (b930649)

No medium-or-higher issues found.

All reviewers found the documentation and sample config changes clean.

---

Synthesized from 3 reviews (agents: codex, gemini | types: default, security)

[roborev-ci]

roborev: Combined Review (ae85803)

No Medium, High, or Critical findings; all reviewers found the documentation-only changes clean.

---

Synthesized from 3 reviews (agents: codex, gemini | types: default, security)