[filipagr]

Follow-up to #45 and #46. Stacked on #46: the base is filipa/docs-followups-content. Review after #46 and retarget as the stack merges.

FIL-1570: information architecture, terminology, SEO

• Sidebar:
  • New Guides and Help categories. Help holds the FAQ, Troubleshooting, Contact support and Service status (status.filone.com).
  • Limits and the new Glossary sit under API Reference.
  • App is renamed Console, with short labels.
  • Generated index pages at /guides and /storage.
• Navbar:
  • /limits no longer highlights "Documentation".
  • API Reference and SDKs & Tools now highlight on their own pages.
• Terminology: "console" for app.filone.com. The product UI never names itself, and the docs already used "console" most. "Dashboard" stays only where it names the Dashboard page, and "left menu" / "left sidebar" became "sidebar".
• Duplicate titles: the console pages are titled "API Keys in the console", "Buckets in the console" and "Billing in the console". Routes are unchanged.
• Descriptions: factual descriptions replace thin ones and the marketing tagline on the introduction.
• Repeated blocks: the endpoint table lives in reference/overview#base-endpoint, and the Governance explanation in object-lock#key-concepts. The other pages link to them.
• Cross-links:
  • Presigned URLs and Share object link to each other.
  • Errors, Authentication and Limits link to each other.
  • Pages that ended without a next step now have Next steps.
• Skipped: og:image, because the repo only has SVG images and og:image needs PNG or JPG.

FIL-1572: new guides (the parts that could be verified)

• Migrate to Fil One (guides/migration):
  • Prerequisites.
  • A two-step aws s3 sync through a local folder.
  • rclone, configured with provider = Other, path-style and no_check_bucket.
  • What carries over: user metadata only with rclone -M; tags, ACLs and version history don't.
• Choosing a region (guides/choosing-a-region): every fact comes from existing pages. It makes no latency or pricing claims.
• Glossary (reference/glossary): 23 terms, each linking to the page that covers it.
• Not done, because these need engineering confirmation: CORS, rate limits, durability mechanism, presigned URL maximum expiry. A changelog and the s3cmd config are also left out.

Testing

• Local S3 emulator (moto, dummy credentials, nothing sent to Fil One or AWS):
  • The migration guide's aws s3 sync steps and rclone copy, check and multipart ran as written.
  • Object counts and sizes matched, and the metadata behaviour is as described.
• Builds and checks: npm run build passes, and ci: build, mirror and snippet checks on every PR; docs-impact checklist #40's mirror and snippet checks pass (37 pages, 99 blocks).
• Mirrors: the llms-full.txt page sections were regenerated, and llms.txt has the new pages and the console terminology.

Not verified

• rclone against the real Fil One endpoints.

Merge notes

• docs: replace AI Agent Toolkit page with an AI agent guide (FIL-1775) #44 removes the AI Agent Toolkit page, which this sidebar still lists as "AI Agent Toolkit" under Console. Whichever merges second needs that entry updated in sidebars.js and in both mirrors.

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
filone-docs	Ready	Preview	Nov 11, 2026 9:43pm UTC