docs: add SEO marketing plan and full docs.md generator#186
docs: add SEO marketing plan and full docs.md generator#186rubenmarcus merged 4 commits intomainfrom
Conversation
- Add comprehensive SEO & marketing strategy doc with 35+ article roadmap, 4-tier keyword strategy, and social media playbook - Add build script to generate a single docs.md from all 39 doc pages - Hook script into docs build so docs.md stays up to date - Serve at /docs.md for easy single-file download Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Issue Linking ReminderThis PR doesn't appear to have a linked issue. Consider linking to:
Using If this PR doesn't need an issue, you can ignore this message. |
🔗 Docs PreviewPreview URL: https://docs-seo-marketing-plan-and-.ralph-starter-docs.pages.dev This preview was deployed from the latest commit on this PR. |
Adds a DownloadDocs component to the docs intro page with two download buttons: .md (full formatted docs) and .txt (llms-full.txt). Styled to match the quantum theme. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Greptile OverviewGreptile Summaryadded comprehensive SEO & marketing strategy documentation and automated full documentation generator. The PR includes a 900+ line SEO plan with keyword strategy, article roadmap, and social media playbooks, plus a build script that concatenates all 39 doc pages into a single downloadable Key changes:
Issues found:
Confidence Score: 5/5
Important Files Changed
Last reviewed commit: 5271740 |
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 5271740d72
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
The heading bumper was running on every line including fenced code blocks, turning shell comments like "# Install" into "## Install". Now tracks fence state and only bumps actual markdown headings. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 7054a56861
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| } | ||
|
|
||
| const raw = fs.readFileSync(filePath, 'utf-8'); | ||
| const content = bumpHeadings(stripFrontmatter(raw)); |
There was a problem hiding this comment.
The concatenation path currently applies only stripFrontmatter and bumpHeadings, then writes content directly, so MDX-only syntax from source pages (for example docs/docs/intro.md now has import DownloadDocs... and <DownloadDocs />) is copied into docs/static/docs.md. This makes the “single markdown file” artifact include non-Markdown implementation details that can confuse downstream markdown parsers and LLM/document ingestion pipelines expecting plain docs content.
Useful? React with 👍 / 👎.
1 participant
Summary
docs/SEO_MARKETING_PLAN.md) with 35+ article roadmap, 4-tier keyword strategy (100+ keywords), and Twitter/LinkedIn/Google playbooksdocs/scripts/generate-full-docs.cjs) that concatenates all 39 doc pages into a singledocs.mdpnpm buildsodocs.mdauto-regenerates on every buildhttps://ralphstarter.ai/docs.mdfor easy single-file downloadTest plan
cd docs && pnpm docs:fullgeneratesstatic/docs.mdsuccessfullypnpm buildin docs dir completes without errorsdocs.mdcontains all 39 doc pages in correct order🤖 Generated with Claude Code