Dev to main, 6th July, 2026#708
Merged
Merged
Conversation
- Lean what/when/architecture overview that routes setup detail to the Configure subfolder - Keep the architecture diagram and the deployment-options table
Reorder the Docs section-switcher dropdown from alphabetical to agent-development-lifecycle order, grouped under lightweight phase headers (Start, Observe & diagnose, Evaluate & measure, Improve, Build & connect, Protect, Assistant, Reference). "Resources" is omitted and "Falcon AI" sits last. The change lands on the live dropdown in Sidebar.astro (Docs tab only; other tabs fall back to a single unlabelled list). A "More" bucket surfaces any future product that isn't placed, so nothing silently disappears. Remove the dead SectionSwitcher.astro and Breadcrumb.astro components: nothing rendered them (DocsLayout uses its own inline breadcrumb), and the build of all 931 pages passes without them.
…on sidebar entries - Requirements-only pre-install checklist: hardware tiers, software (Docker 24.0+, Compose v2.20+, Git 2.0+) with per-OS install tabs, platform compatibility, and the network-ports reference. - Correct to current repo facts: AGENTCC_GATEWAY_PORT, 0.0.0.0 app-service binds, PeerDB ports only under COMPOSE_PROFILES=full. - Add Git as a prerequisite; fix the Windows WSL 2 memory guidance. - Sidebar: rename 'System requirements' -> 'Requirements' and add 'Installation'. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- New Installation page for the current ./bin/install flow: Steps (clone + install, create first user via manage.py create_user, open the app), installer flags, Apple Silicon/arm64 note, manual install, verify-the-stack, everyday operations, and the dev/frontend run modes. - 'Deep dive' card to Environment variables (System configuration card omitted since that page is not in the base branch). - Replaces the old build-from-source v1.8.19_base draft with the published-image flow; every command verified against the live future-agi/future-agi repo. - Sidebar: rename 'System requirements' -> 'Requirements' and add 'Installation'. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- title: sentence case to match sidebar label - description: remove em-dash, shorten to single purpose line - convert short-on-time Note to TLDR - remove em-dash from intro paragraph TH-6328
- Title -> 'Requirements' (sync with sidebar); shorten description. - 'Introduction' -> 'In this page'; intro three-checks as bullets. - Note -> TLDR for the short-on-time summary. - Uniform OS tabs (consistent lead line); remove stranded macOS Docker Desktop line. - Update Install link + nav href for the install -> installation rename. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Rename install.mdx -> installation.mdx (file = kebab of sidebar title); nav href updated. - Title -> 'Installation'; shorten description. - 'Introduction' -> 'In this page'; bullet the installer-does-this enumeration (de-duped Step 1). - Note -> TLDR. Footer 'Deep dive' -> 'Dive deeper'. - Drop trailing periods in the flags + modes tables and the card body. - Point the env card at the canonical nav path /docs/self-hosting/environment. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Complete .env reference under Configuration, self-reviewed against the docs review guide (review-docs-like-khushal). TH-6328
feat(docs): reorder product dropdown by agent lifecycle
…d readiness claims (#697 review)
Self-hosting: Installation page
… Support Sidebar reshaped to the agreed tree: Configuration and Production as nested groups. Production split from the flat page into Checklist, Security & TLS, Backups & restore, Monitoring, and Upgrades & rollback. New Support page. Production overview slimmed to route into the subsection.
Addresses Khushal's #705 review. Every claim re-grounded in the product repo: - Checklist: real dev-only defaults + deploy/docker-compose.production.yml ${VAR:?} guard, full required-secrets list; PG (first-boot) vs MinIO (every-boot); managed stores are edited in compose (hardcoded hosts), not .env; S3 via STORAGE_BACKEND - Backups: Redis is a cache (RabbitMQ holds the queue); pg_dump -T; futureagi_ volume prefix + full list; ClickHouse needs its own backup post-CH25 (spans don't return from PeerDB) - Monitoring: no /metrics endpoint exists; reworked around docker health, fi-collector :9464, PeerDB UI - Upgrades: peerdb-init needs no args; PeerDB init is not the ClickHouse recovery path - Support: correct Discord invite; dropped the backward-pointing footer - Nav: Production Overview child so /production is reachable
…ring card/claim - Split the overview into 'Before you go live' (2) and 'Operating it' (3) so no lone orphan card - Overview Monitoring card no longer promises Prometheus metrics (the page was reworked away from a non-existent /metrics) - fi-collector healthz confirms the collector is up, not that it's 'accepting spans'
docs: restructure self-hosting sidebar; add Production subsection and Support
- title: sentence case to match sidebar label - description: remove em-dash, shorten to single purpose line TH-6329
- Fix /configure -> /configuration link typo on the overview (prose + card) - Rename System configuration opener from Introduction to In this page - Drop em-dashes across the page (intro + gateway/PeerDB sections) - Fix gateway config path: agentcc-gateway is at repo root, not under futureagi/
… stale install link (#695 review)
docs: add self-hosting system configuration page
Complete .env reference under Configuration, self-reviewed against the docs review guide (review-docs-like-khushal). TH-6328
# Conflicts: # src/lib/navigation.ts
docs: add self-hosting environment variables page
Self-hosting: Requirements page
…; redirect retired env page
…iables in the sidebar
Self hosting section changes
hadarishav
approved these changes
Jul 6, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Pull Request
Description
Describe the changes in this pull request:
Checklist
Related Issues
Closes #<issue_number>