Skip to content

Add Docs7 documentation as a new docs tab - #3024

Open
enesgules wants to merge 10 commits into
masterfrom
enes/docs7-docs
Open

Add Docs7 documentation as a new docs tab#3024
enesgules wants to merge 10 commits into
masterfrom
enes/docs7-docs

Conversation

@enesgules

@enesgules enesgules commented Aug 12, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Converts the docs navigation from top-level groups to two tabs: Context7 (the existing content, unchanged) and Docs7 (new).
  • Adds 19 pages documenting the Docs7 hosting product:
    • Getting Started: overview, quickstart, Mintlify compatibility
    • Configuration: site settings (docs.json reference), navigation, frontmatter, redirects, ignoring files
    • Writing: components, code blocks, snippets & variables, OpenAPI references
    • Features: analytics (AI traffic with IP-range verification + privacy-safe human analytics), search, SEO & social cards, AI & agents
    • Deploying: deployments (with troubleshooting table), branch previews, custom domains, limits

Notes

  • Every claim was verified against the docs7 builder/service source rather than Mintlify's docs — including places where they differ (icon library default is Hugeicons, custom .js is not injected, versions/languages selectors don't scope content, no API playground).
  • Limits values match the production defaults in the docs7 service config.
  • Docs7 is still gated to admin accounts (TODO(docs7-launch)), so merge timing should follow the launch plan.

https://claude.ai/code/session_01XcVqineTHvy9bJuocZA6za

@enesgules
Add Docs7 documentation as a new docs tab
74abd26 
Converts the docs navigation to tabs (Context7, Docs7) and adds 19 pages
covering the Docs7 hosting product: getting started, configuration,
writing, features (including AI traffic analytics), and deploying.
Content verified against the docs7 builder and service source.

Claude-Session: https://claude.ai/code/session_01XcVqineTHvy9bJuocZA6za
@mintlify

mintlify Bot commented Aug 12, 2026 •
edited
Loading

Copy link
Copy Markdown

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
context7 🟢 Ready View Preview Aug 12, 2026, 11:35 AM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@enesgules
Fix documented behavior against current code and add the Dashboard page
e0d62d9 
Corrects hostname format, analytics coverage and views, preview teardown
triggers, removed chat widget, image actions, nav-hidden semantics, icon
libraries, Latex, diff markers, and pagination modes. Adds the Dashboard
page (statuses, deployments drawer, manual deploys, permissions, deletion)
and fills gaps: heading anchors, Update tag filters, OpenAPI page URLs,
banner color, markdown.schema, private repos.

Claude-Session: https://claude.ai/code/session_01XcVqineTHvy9bJuocZA6za
@enesgules enesgules mentioned this pull request Aug 12, 2026
Closed
@enesgules
docs(docs7): document limits per plan
6b13807 
The limits page stated a single set of numbers, several of which are
actually plan boundaries: sites per teamspace was listed as "No cap",
and the preview cap, build timeout, and analytics window were shown as
global constants.

Splits the page into plan limits (a Free/Pro/Enterprise table drawn
from the Docs7 plan design) and platform limits that apply everywhere,
and adds the two things the plan design makes explicit but the page
never said: that going over the build quota queues rather than fails,
and what is deliberately never metered on any plan.

Updates the three other pages that hardcoded a plan number: branch
previews (5 on Free, 50 on Pro), the build timeout in the deployment
failure table, and the analytics window.

Claude-Session: https://claude.ai/code/session_01TAinxwDauo7a63ZxA4uLh9
@enesgules

enesgules commented Aug 13, 2026

Copy link
Copy Markdown
Collaborator Author

Limits are now documented per plan

limits.mdx is split into plan limits (Free/Pro/Enterprise table) and platform limits that apply everywhere. Three other pages that hardcoded a plan number were updated to match: branch-previews.mdx, deployments.mdx, and analytics.mdx.

Merge blocker: none of these limits are enforced yet

The numbers come from the Docs7 plan design, where they are proposals. Verified against the code today:

Documented limit Enforcement today
Sites: 1 Free / 25 Pro No cap anywhere. No site-count check exists
Builds: 100/mo Free, 5,000/mo Pro Does not exist. No monthly counter, no quota check, no low-priority queue
Build timeout: 15 min Free / 30 Pro Global DOCS_BUILD_TIMEOUT_MS, default 15 min (src/service/config.ts:94). Not plan-aware
Previews: 5 Free / 50 Pro Hardcoded MAX_PREVIEW_TARGETS = 50 (src/service/deploymentRunner.ts:55). Not plan-aware
Retention: 30 days / 12 months / unlimited Query-time window only, fixed to 7/30/90 (lib/util/queryParams.ts:58). No stored TTL
Private repositories: Pro and above The GitHub App distinguishes private repos, but no plan gate reads it

lib/docs/ in context7app contains no plan reads at all. There is also no teamspace plan tier to read: Context7 billing is usage-based per teamspace today.

Docs7 is still admin-gated behind TODO(docs7-launch), so nothing here is public yet. But this page should not merge to the live docs site ahead of the enforcement work, or it documents limits users can exceed freely.

Two prices also need a decision before this is public: $199/mo flat for Pro and the 25-site cap, both flagged as open questions in the plan design.

enesgules
enesgules commented Aug 13, 2026
View reviewed changes
Comment thread docs/docs7/settings.mdx Outdated
@enesgules
docs(docs7): document the Docs Agent
ae33057 
Covers what the agent works from (reader questions and deployment health
issues), how to run it, the three run outcomes, the write scope that keeps
it confined to the docs path, and per-plan run limits.

Claude-Session: https://claude.ai/code/session_01XcVqineTHvy9bJuocZA6za
@enesgules
docs(docs7): previews come from pull requests, and seat pricing
d695baf 
Previews are a paid feature created when a pull request opens and removed
when it closes. Documents the included seat count. Drops the per-plan agent
numbers from the public page.

Claude-Session: https://claude.ai/code/session_01XcVqineTHvy9bJuocZA6za
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@enesgules