Skip to content

DOC-3471, DOC-3476: Markdown endpoints in LLM generator + Context7 MCP instructions #4123

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
kemister85 wants to merge 1 commit into
base: tinymce/8
Choose a base branch
from
+573 −507
Open

DOC-3471, DOC-3476: Markdown endpoints in LLM generator + Context7 MCP instructions #4123

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
43 changes: 41 additions & 2 deletions -scripts/generate-llm-files.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,18 @@ const BASE_URL = 'https://www.tiny.cloud/docs/tinymce/latest';
const DOCS_ROOT_URL = 'https://www.tiny.cloud/docs';
const OUTPUT_DIR = path.join(__dirname, '../modules/ROOT/attachments');

// Convert a trailing-slash doc URL to its Markdown endpoint.
// e.g. https://www.tiny.cloud/docs/tinymce/latest/basic-setup/
// -> https://www.tiny.cloud/docs/tinymce/latest/basic-setup/index.md
// Rewrite doc page URLs from trailing-slash to index.md Markdown endpoints.
// Only affects URLs under /docs/tinymce/; CDN and file URLs are unchanged.
function toMarkdownEndpoints(content) {
return content.replace(
/https:\/\/www\.tiny\.cloud\/docs\/tinymce\/[^\s)"]+/g,
(match) => match.endsWith('/') ? match + 'index.md' : match
);
}

// Fetch sitemap from URL or file
async function getSitemap(source) {
if (source.startsWith('http://') || source.startsWith('https://')) {
Expand Down Expand Up @@ -1206,6 +1218,33 @@ TinyMCE AI (\`tinymceai\` plugin) is the current AI writing assistant for TinyMC
- [Upgrading TinyMCE](${BASE_URL}/upgrading/): Upgrade guide
- [Migration from 7.x](${BASE_URL}/migration-from-7x/): Migrate from TinyMCE 7

## AI-Assisted Development with MCP

For up-to-date TinyMCE documentation directly in AI coding tools, set up the Context7 MCP server. TinyMCE docs are indexed at [context7.com/tinymce/tinymce-docs](https://context7.com/tinymce/tinymce-docs).

### Cursor

Add to \`.cursor/mcp.json\`:

\`\`\`json
{
"mcpServers": {
"context7": {
"command": "npx",
"args": ["-y", "@upstash/context7-mcp"]
}
}
}
\`\`\`

### Claude Code

\`\`\`bash
claude mcp add context7 -- npx -y @upstash/context7-mcp
\`\`\`

Add "use context7" to any prompt for live TinyMCE documentation lookups.

## Complete Documentation

For a complete list of all ${urls.length} documentation pages, see [llms-full.txt](${DOCS_ROOT_URL}/llms-full.txt).
Expand All @@ -1225,11 +1264,11 @@ async function main() {
const urls = parseSitemap(sitemapContent);
console.log(`Found ${urls.length} unique URLs in sitemap`);

const llmsTxt = generateLLMsTxt(urls);
const llmsTxt = toMarkdownEndpoints(generateLLMsTxt(urls));
fs.writeFileSync(path.join(OUTPUT_DIR, 'llms.txt'), llmsTxt);
console.log('✓ Generated llms.txt');

const llmsFullTxt = await generateLLMsFullTxt(urls);
const llmsFullTxt = toMarkdownEndpoints(await generateLLMsFullTxt(urls));
fs.writeFileSync(path.join(OUTPUT_DIR, 'llms-full.txt'), llmsFullTxt);
console.log('✓ Generated llms-full.txt');

Expand Down
Loading
Loading