feat: Complete Phase 5C and Phase 5D documentation, including performance metrics, SEO optimization, and advanced features implementation
docs: Add production deployment success documentation for Azure Static Web App docs: Create Quick Start guide for project setup and deployment instructions docs: Update README.md to include new documentation links and structure docs: Enhance User Manual with detailed portal access, roles, and AI assistance features scripts: Implement architecture diagram export script using Mermaid CLI scripts: Create script to auto-generate documentation index for easier navigation chore: Remove unused update-doc-index script
This commit is contained in:
55
scripts/generate-doc-index.mjs
Normal file
55
scripts/generate-doc-index.mjs
Normal file
@@ -0,0 +1,55 @@
|
||||
#!/usr/bin/env node
|
||||
/**
|
||||
* Auto-generate docs/README.md index.
|
||||
* Scans docs directory for .md files (excluding README.md) and categorizes by simple heuristics.
|
||||
*/
|
||||
import { readdirSync, readFileSync, writeFileSync } from 'fs'
|
||||
import { join } from 'path'
|
||||
|
||||
const DOCS_DIR = join(process.cwd(), 'docs')
|
||||
const OUTPUT = join(DOCS_DIR, 'README.md')
|
||||
|
||||
// Basic categorization keywords
|
||||
const categories = [
|
||||
{ name: 'Getting Started', match: [/quickstart/i, /usermanual/i] },
|
||||
{ name: 'Architecture & Engineering', match: [/architecture/i, /implementation/i, /diagram/i] },
|
||||
{ name: 'Delivery & Reports', match: [/completion/i, /deployment/, /update/, /phases_all/i, /production_deployment/ ] },
|
||||
{ name: 'Performance & Optimization', match: [/performance/i, /seo/i] },
|
||||
{ name: 'Change History', match: [/changelog/i] },
|
||||
{ name: 'AI & Advanced Features', match: [/ai/i] }
|
||||
]
|
||||
|
||||
function categorize(file) {
|
||||
const lower = file.toLowerCase()
|
||||
for (const cat of categories) {
|
||||
if (cat.match.some(r => r.test(lower))) return cat.name
|
||||
}
|
||||
return 'Other'
|
||||
}
|
||||
|
||||
function build() {
|
||||
const files = readdirSync(DOCS_DIR)
|
||||
.filter(f => f.endsWith('.md') && f !== 'README.md')
|
||||
.sort()
|
||||
|
||||
const byCategory = {}
|
||||
for (const f of files) {
|
||||
const cat = categorize(f)
|
||||
byCategory[cat] = byCategory[cat] || []
|
||||
byCategory[cat].push(f)
|
||||
}
|
||||
|
||||
const quickLinks = files.map(f => `- [${f.replace(/_/g,' ')}](./${f})`).join('\n')
|
||||
|
||||
let body = '# Documentation Index\n\n(Generated by scripts/generate-doc-index.mjs)\n\n## Quick Links\n' + quickLinks + '\n\n'
|
||||
|
||||
for (const cat of Object.keys(byCategory).sort()) {
|
||||
body += `### ${cat}\n` + byCategory[cat].map(f => `- ${f}`).join('\n') + '\n\n'
|
||||
}
|
||||
|
||||
body += '---\nLast regenerated: ' + new Date().toISOString() + '\n'
|
||||
writeFileSync(OUTPUT, body)
|
||||
console.log('docs/README.md regenerated.')
|
||||
}
|
||||
|
||||
build()
|
||||
Reference in New Issue
Block a user