remove public docs surface#243
Merged
Merged
Conversation
nahiyankhan
marked this pull request as ready for review
July 20, 2026 20:30
Merged
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
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.
Category: improvement
User Impact: The public site now presents only ghost's thesis instead of implying that the project is ready for documentation-led adoption.
Problem: The docs surface and persistent menu suggested an onboarding and support posture that ghost is not ready to maintain.
Solution: Remove the public docs routes, MDX pipeline, menu, generated CLI reference, and related maintenance checks. Keep the homepage as the sole public surface, redirect old paths home, and direct command questions to CLI help.
Validation:
pnpm check: passedpnpm test: 192 passed, 1 skippedpnpm build: passed/docsredirected to/Changeset: added a patch changeset for the public README and documentation-link cleanup.
ghost Review:
ghost check --base origin/main: not run because the current CLI does not expose acheckcommand.ghost review --base origin/main --include-memory: not run because the current CLI does not support--include-memory; visual output was reviewed directly in-browser.File changes
.changeset/honest-development-preview.mdRecords the public-package documentation cleanup.
README.md,packages/ghost/README.mdReplace documentation links with the project-site framing and direct readers to CLI help for current command behavior.
CLAUDE.md,CONTRIBUTING.md,docs/README.md,docs/purposes.md,apps/docs/README.mdRemove stale docs-generation instructions and describe
apps/docsas the public thesis site.apps/docs/src/App.tsxRemove docs routes and the persistent dock; redirect all non-home routes to
/.apps/docs/src/app/page.tsx,apps/docs/src/components/docs/hero.tsx,apps/docs/src/components/docs/docs-page-layout.tsx,apps/docs/src/styles/marked-doc.cssKeep the revised homepage, remove its docs CTA and menu dependency, and retain only styles used by the thesis surface.
apps/docs/src/app/docs/**,apps/docs/src/content/**,apps/docs/src/routes/**,apps/docs/src/mdx-components.tsx, docs-only componentsRemove the public documentation pages and their rendering/navigation infrastructure.
apps/docs/vite.config.ts,apps/docs/package.json,pnpm-lock.yaml,apps/docs/src/vite-env.d.tsRemove MDX and documentation-only build dependencies.
package.json,scripts/check-docs-frontmatter.mjs,scripts/dump-cli-help.mjs,scripts/check-terminology.mjs,apps/docs/src/generated/cli-manifest.jsonRemove obsolete docs-frontmatter and generated CLI-manifest maintenance paths.
Screenshots/Demos: Homepage rendered locally after removing the menu; no new visual design beyond the existing homepage work.