@knowcode/doc-builder 1.5.7 → 1.5.9

package/CHANGELOG.md

@@ -5,6 +5,46 @@ All notable changes to @knowcode/doc-builder will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.5.9] - 2025-07-22
+
+### Added
+- Comprehensive SEO Optimization Guide with extensive external resources
+- Detailed explanations of all SEO features and how they work
+- References to 20+ external SEO tools and learning resources
+- Keyword research tools and performance testing recommendations
+- SEO monitoring strategies and success metrics
+- Actionable SEO checklist for documentation projects
+
+### Documentation
+- Created detailed guide explaining automatic meta tag generation
+- Added sections on Open Graph Protocol and Twitter Cards
+- Included structured data (JSON-LD) explanations
+- Referenced Google's official SEO guidelines and best practices
+- Added links to free SEO tools and validators
+
+## [1.5.8] - 2025-07-22
+
+### Changed
+- **BREAKING**: `seo-check` command now analyzes generated HTML files instead of markdown source files
+- Completely rewrote SEO analysis to inspect actual HTML output that search engines see
+- Added comprehensive checks for all SEO elements in HTML including:
+  - Title tags and optimal length
+  - Meta descriptions and character limits
+  - Keywords meta tags
+  - Canonical URLs
+  - H1 tags and consistency with titles
+  - Open Graph tags for social media
+  - Twitter Card tags
+  - Structured data (JSON-LD)
+- Updated help text and examples to reflect HTML analysis
+- Improved error messages to guide users to build HTML first
+
+### Why This Change?
+- SEO analysis should check what search engines actually see (the generated HTML)
+- Provides more accurate and comprehensive SEO insights
+- Can verify that all meta tags are properly generated
+- Ensures Open Graph and Twitter Cards are working correctly
+
 ## [1.5.7] - 2025-07-22
 
 ### Fixed

package/cli.js

@@ -196,36 +196,38 @@ ${chalk.yellow('Get your verification code from Google Search Console.')}
 // SEO Check command
 program
   .command('seo-check [path]')
-  .description('Analyze SEO for your documentation pages')
+  .description('Analyze SEO metadata in generated HTML files')
   .option('-c, --config <path>', 'path to config file (default: doc-builder.config.js)')
-  .option('--fix', 'auto-fix common SEO issues')
   .addHelpText('after', `
 ${chalk.yellow('Examples:')}
-  ${chalk.gray('$')} doc-builder seo-check                    ${chalk.gray('# Check all pages')}
-  ${chalk.gray('$')} doc-builder seo-check docs/guide.md      ${chalk.gray('# Check specific page')}
-  ${chalk.gray('$')} doc-builder seo-check --fix              ${chalk.gray('# Auto-fix issues')}
-
-${chalk.yellow('This command analyzes:')}
-  • Title length and optimization (50-60 characters)
-  • Meta descriptions (140-160 characters)
-  • Keywords usage and relevance
-  • Front matter SEO fields
-  • Duplicate content issues
+  ${chalk.gray('$')} doc-builder seo-check                    ${chalk.gray('# Check all HTML pages')}
+  ${chalk.gray('$')} doc-builder seo-check html/guide.html    ${chalk.gray('# Check specific HTML file')}
+
+${chalk.yellow('This command analyzes generated HTML files for:')}
+  • Title tags and length (50-60 characters)
+  • Meta descriptions (140-160 characters)  
+  • Keywords meta tags
+  • Canonical URLs
+  • H1 tags and consistency
+  • Open Graph tags (Facebook)
+  • Twitter Card tags
+  • Structured data (JSON-LD)
+  
+${chalk.yellow('Note:')} Run 'doc-builder build' first to generate HTML files.
 `)
   .action(async (filePath, options) => {
     try {
       const config = await loadConfig(options.config || 'doc-builder.config.js', options);
-      const docsDir = path.resolve(config.docsDir || 'docs');
+      const outputDir = path.resolve(config.outputDir || 'html');
       
-      // Check if docsDir exists
-      if (!await fs.pathExists(docsDir)) {
-        console.error(chalk.red(`Documentation directory not found: ${docsDir}`));
-        console.log(chalk.yellow('\nPlease ensure you have a docs directory with markdown files.'));
-        console.log(chalk.gray(`Create it with: mkdir docs && echo "# Documentation" > docs/README.md`));
+      // Check if outputDir exists
+      if (!await fs.pathExists(outputDir)) {
+        console.error(chalk.red(`Output directory not found: ${outputDir}`));
+        console.log(chalk.yellow('\nPlease build your documentation first with: doc-builder build'));
         process.exit(1);
       }
       
-      console.log(chalk.cyan('🔍 Analyzing SEO...'));
+      console.log(chalk.cyan('🔍 Analyzing SEO in generated HTML files...'));
       
       // Get files to check
       let files = [];
@@ -238,7 +240,7 @@ ${chalk.yellow('This command analyzes:')}
           process.exit(1);
         }
       } else {
-        // Get all markdown files
+        // Get all HTML files
         const getAllFiles = async (dir) => {
           const results = [];
           const items = await fs.readdir(dir);
@@ -247,13 +249,13 @@ ${chalk.yellow('This command analyzes:')}
             const stat = await fs.stat(fullPath);
             if (stat.isDirectory() && !item.startsWith('.')) {
               results.push(...await getAllFiles(fullPath));
-            } else if (item.endsWith('.md')) {
+            } else if (item.endsWith('.html') && item !== '404.html') {
               results.push(fullPath);
             }
           }
           return results;
         };
-        files = await getAllFiles(docsDir);
+        files = await getAllFiles(outputDir);
       }
       
       // Analyze each file
@@ -262,19 +264,43 @@ ${chalk.yellow('This command analyzes:')}
       
       for (const file of files) {
         const content = await fs.readFile(file, 'utf-8');
-        const { data: frontMatter, content: mainContent } = matter(content);
-        const relativePath = path.relative(docsDir, file);
+        const relativePath = path.relative(outputDir, file);
+        
+        // Extract metadata from HTML
+        const titleMatch = content.match(/<title>([^<]+)<\/title>/);
+        const descMatch = content.match(/<meta\s+name="description"\s+content="([^"]+)"/);
+        const keywordsMatch = content.match(/<meta\s+name="keywords"\s+content="([^"]+)"/);
+        const canonicalMatch = content.match(/<link\s+rel="canonical"\s+href="([^"]+)"/);
+        const h1Match = content.match(/<h1>([^<]+)<\/h1>/);
+        
+        const title = titleMatch ? titleMatch[1] : 'No title found';
+        const description = descMatch ? descMatch[1] : '';
+        const keywords = keywordsMatch ? keywordsMatch[1].split(',').map(k => k.trim()) : [];
+        const canonical = canonicalMatch ? canonicalMatch[1] : '';
+        const h1 = h1Match ? h1Match[1] : '';
+        
+        // Check for Open Graph tags
+        const ogTitleMatch = content.match(/<meta\s+property="og:title"\s+content="([^"]+)"/);
+        const ogDescMatch = content.match(/<meta\s+property="og:description"\s+content="([^"]+)"/);
+        const ogImageMatch = content.match(/<meta\s+property="og:image"\s+content="([^"]+)"/);
+        
+        // Check for Twitter Card tags
+        const twitterTitleMatch = content.match(/<meta\s+name="twitter:title"\s+content="([^"]+)"/);
+        const twitterDescMatch = content.match(/<meta\s+name="twitter:description"\s+content="([^"]+)"/);
         
-        // Extract current metadata
-        const h1Match = mainContent.match(/^#\s+(.+)$/m);
-        const h1Title = h1Match ? h1Match[1] : null;
-        const title = frontMatter.title || h1Title || path.basename(file, '.md');
-        const description = frontMatter.description || generateDescription(mainContent, 'smart');
-        const keywords = frontMatter.keywords || [];
+        // Check for structured data
+        const structuredDataMatch = content.match(/<script\s+type="application\/ld\+json">/);
         
         // Check title
         const titleLength = title.length;
-        if (titleLength > 60) {
+        if (!titleMatch) {
+          issues.push({
+            file: relativePath,
+            type: 'title',
+            message: 'Missing <title> tag',
+            severity: 'critical'
+          });
+        } else if (titleLength > 60) {
           issues.push({
             file: relativePath,
             type: 'title',
@@ -291,38 +317,90 @@ ${chalk.yellow('This command analyzes:')}
         }
         
         // Check description
-        const descLength = description.length;
-        if (descLength > 160) {
+        if (!descMatch) {
           issues.push({
             file: relativePath,
             type: 'description',
-            message: `Description too long (${descLength} chars, max 160)`,
+            message: 'Missing meta description',
+            severity: 'critical'
+          });
+        } else {
+          const descLength = description.length;
+          if (descLength > 160) {
+            issues.push({
+              file: relativePath,
+              type: 'description',
+              message: `Description too long (${descLength} chars, max 160)`,
             current: description,
             suggestion: description.substring(0, 157) + '...'
           });
-        } else if (descLength < 120) {
+          } else if (descLength < 120) {
+            suggestions.push({
+              file: relativePath,
+              type: 'description',
+              message: `Description might be too short (${descLength} chars, ideal 140-160)`
+            });
+          }
+        }
+        
+        // Check keywords
+        if (!keywordsMatch || keywords.length === 0) {
           suggestions.push({
             file: relativePath,
-            type: 'description',
-            message: `Description might be too short (${descLength} chars, ideal 140-160)`
+            type: 'keywords',
+            message: 'No keywords meta tag found'
           });
         }
         
-        // Check keywords
-        if (keywords.length === 0 && !frontMatter.description) {
+        // Check canonical URL
+        if (!canonicalMatch) {
           suggestions.push({
             file: relativePath,
-            type: 'keywords',
-            message: 'No keywords defined in front matter'
+            type: 'canonical',
+            message: 'Missing canonical URL'
+          });
+        }
+        
+        // Check H1
+        if (!h1Match) {
+          issues.push({
+            file: relativePath,
+            type: 'h1',
+            message: 'Missing H1 tag',
+            severity: 'important'
+          });
+        } else if (h1 !== title.split(' | ')[0]) {
+          suggestions.push({
+            file: relativePath,
+            type: 'h1',
+            message: 'H1 differs from page title'
+          });
+        }
+        
+        // Check Open Graph tags
+        if (!ogTitleMatch || !ogDescMatch) {
+          suggestions.push({
+            file: relativePath,
+            type: 'opengraph',
+            message: 'Missing or incomplete Open Graph tags'
+          });
+        }
+        
+        // Check Twitter Card tags
+        if (!twitterTitleMatch || !twitterDescMatch) {
+          suggestions.push({
+            file: relativePath,
+            type: 'twitter',
+            message: 'Missing or incomplete Twitter Card tags'
           });
         }
         
-        // Check for front matter
-        if (!frontMatter.title && !frontMatter.description) {
+        // Check structured data
+        if (!structuredDataMatch) {
           suggestions.push({
             file: relativePath,
-            type: 'frontmatter',
-            message: 'No SEO front matter found'
+            type: 'structured-data',
+            message: 'Missing structured data (JSON-LD)'
           });
         }
       }
@@ -353,15 +431,16 @@ ${chalk.yellow('This command analyzes:')}
           });
         }
         
-        console.log(`\n${chalk.cyan('💡 Tips:')}`);
-        console.log('  • Add front matter to customize SEO per page');
+        console.log(`\n${chalk.cyan('💡 Tips to improve SEO:')}`);
+        console.log('  • Add front matter to markdown files to customize SEO');
         console.log('  • Keep titles between 50-60 characters');
         console.log('  • Write descriptions between 140-160 characters');
         console.log('  • Include relevant keywords in front matter');
-        console.log(`\n${chalk.gray('Example front matter:')}`);
+        console.log('  • Ensure each page has a unique title and description');
+        console.log(`\n${chalk.gray('Add to your markdown files:')}`);
         console.log(chalk.gray('---'));
         console.log(chalk.gray('title: "Your SEO Optimized Title Here"'));
-        console.log(chalk.gray('description: "A compelling description between 140-160 characters that includes keywords and encourages clicks."'));
+        console.log(chalk.gray('description: "A compelling description between 140-160 characters."'));
         console.log(chalk.gray('keywords: ["keyword1", "keyword2", "keyword3"]'));
         console.log(chalk.gray('---'));
       }

package/html/README.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.857Z",
-  "dateModified": "2025-07-22T08:09:57.857Z",
+  "datePublished": "2025-07-22T08:28:44.971Z",
+  "dateModified": "2025-07-22T08:28:44.971Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/README.html"
@@ -95,7 +95,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.8">Last updated: Jul 22, 2025, 08:28 AM UTC</span>
                 </div>
                 
                 
@@ -158,7 +158,7 @@
         <a href="/guides/documentation-standards.html" class="nav-item" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
         <a href="/guides/google-site-verification-guide.html" class="nav-item" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
-        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Good SEO helps your documentation: Rank higher in search results Get more organic traffic Improve click-through rates Reach the right audience Build..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
+        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item" data-tooltip="This guide helps you resolve common issues when using @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Troubleshooting Guide</a></div></div>
             </nav>
             <div class="resize-handle"></div>

package/html/documentation-index.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.871Z",
-  "dateModified": "2025-07-22T08:09:57.871Z",
+  "datePublished": "2025-07-22T08:28:44.983Z",
+  "dateModified": "2025-07-22T08:28:44.983Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/documentation-index.html"
@@ -95,7 +95,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.8">Last updated: Jul 22, 2025, 08:28 AM UTC</span>
                 </div>
                 
                 
@@ -158,7 +158,7 @@
         <a href="/guides/documentation-standards.html" class="nav-item" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
         <a href="/guides/google-site-verification-guide.html" class="nav-item" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
-        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Good SEO helps your documentation: Rank higher in search results Get more organic traffic Improve click-through rates Reach the right audience Build..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
+        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item" data-tooltip="This guide helps you resolve common issues when using @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Troubleshooting Guide</a></div></div>
             </nav>
             <div class="resize-handle"></div>

package/html/guides/authentication-guide.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.875Z",
-  "dateModified": "2025-07-22T08:09:57.875Z",
+  "datePublished": "2025-07-22T08:28:44.986Z",
+  "dateModified": "2025-07-22T08:28:44.986Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/authentication-guide.html"
@@ -101,7 +101,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.8">Last updated: Jul 22, 2025, 08:28 AM UTC</span>
                 </div>
                 
                 
@@ -164,7 +164,7 @@
         <a href="/guides/documentation-standards.html" class="nav-item" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
         <a href="/guides/google-site-verification-guide.html" class="nav-item" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
-        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Good SEO helps your documentation: Rank higher in search results Get more organic traffic Improve click-through rates Reach the right audience Build..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
+        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item" data-tooltip="This guide helps you resolve common issues when using @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Troubleshooting Guide</a></div></div>
             </nav>
             <div class="resize-handle"></div>

package/html/guides/claude-workflow-guide.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.879Z",
-  "dateModified": "2025-07-22T08:09:57.879Z",
+  "datePublished": "2025-07-22T08:28:44.989Z",
+  "dateModified": "2025-07-22T08:28:44.989Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/claude-workflow-guide.html"
@@ -101,7 +101,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.8">Last updated: Jul 22, 2025, 08:28 AM UTC</span>
                 </div>
                 
                 
@@ -164,7 +164,7 @@
         <a href="/guides/documentation-standards.html" class="nav-item" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
         <a href="/guides/google-site-verification-guide.html" class="nav-item" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
-        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Good SEO helps your documentation: Rank higher in search results Get more organic traffic Improve click-through rates Reach the right audience Build..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
+        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item" data-tooltip="This guide helps you resolve common issues when using @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Troubleshooting Guide</a></div></div>
             </nav>
             <div class="resize-handle"></div>

package/html/guides/documentation-standards.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.884Z",
-  "dateModified": "2025-07-22T08:09:57.884Z",
+  "datePublished": "2025-07-22T08:28:44.992Z",
+  "dateModified": "2025-07-22T08:28:44.992Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/documentation-standards.html"
@@ -101,7 +101,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.8">Last updated: Jul 22, 2025, 08:28 AM UTC</span>
                 </div>
                 
                 
@@ -164,7 +164,7 @@
         <a href="/guides/documentation-standards.html" class="nav-item active" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
         <a href="/guides/google-site-verification-guide.html" class="nav-item" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
-        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Good SEO helps your documentation: Rank higher in search results Get more organic traffic Improve click-through rates Reach the right audience Build..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
+        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item" data-tooltip="This guide helps you resolve common issues when using @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Troubleshooting Guide</a></div></div>
             </nav>
             <div class="resize-handle"></div>

package/html/guides/google-site-verification-guide.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.893Z",
-  "dateModified": "2025-07-22T08:09:57.893Z",
+  "datePublished": "2025-07-22T08:28:45.000Z",
+  "dateModified": "2025-07-22T08:28:45.000Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/google-site-verification-guide.html"
@@ -101,7 +101,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.8">Last updated: Jul 22, 2025, 08:28 AM UTC</span>
                 </div>
                 
                 
@@ -164,7 +164,7 @@
         <a href="/guides/documentation-standards.html" class="nav-item" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
         <a href="/guides/google-site-verification-guide.html" class="nav-item active" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
-        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Good SEO helps your documentation: Rank higher in search results Get more organic traffic Improve click-through rates Reach the right audience Build..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
+        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item" data-tooltip="This guide helps you resolve common issues when using @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Troubleshooting Guide</a></div></div>
             </nav>
             <div class="resize-handle"></div>

package/html/guides/seo-guide.html

@@ -61,8 +61,8 @@
     "name": "Knowcode Ltd",
     "url": "https://knowcode.tech"
   },
-  "datePublished": "2025-07-22T08:09:57.898Z",
-  "dateModified": "2025-07-22T08:09:57.898Z",
+  "datePublished": "2025-07-22T08:28:45.004Z",
+  "dateModified": "2025-07-22T08:28:45.004Z",
   "mainEntityOfPage": {
     "@type": "WebPage",
     "@id": "https://doc-builder-delta.vercel.app/guides/seo-guide.html"
@@ -101,7 +101,7 @@
             
             <div class="header-actions">
                 <div class="deployment-info">
-                    <span class="deployment-date" title="Built with doc-builder v1.5.5">Last updated: Jul 22, 2025, 08:09 AM UTC</span>
+                    <span class="deployment-date" title="Built with doc-builder v1.5.8">Last updated: Jul 22, 2025, 08:28 AM UTC</span>
                 </div>
                 
                 
@@ -164,7 +164,7 @@
         <a href="/guides/documentation-standards.html" class="nav-item" data-tooltip="This document defines the documentation standards and conventions for the @knowcode/doc-builder project."><i class="fas fa-file-alt"></i> Documentation Standards</a>
         <a href="/guides/google-site-verification-guide.html" class="nav-item" data-tooltip="Google Search Console verification allows you to: Monitor your site&#039;s performance in Google Search Submit sitemaps for better indexing View search..."><i class="fas fa-file-alt"></i> Google Site Verification Guide</a>
         <a href="/guides/seo-guide.html" class="nav-item active" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features to help your documentation rank better in search results and..."><i class="fas fa-file-alt"></i> Seo Guide</a>
-        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="Good SEO helps your documentation: Rank higher in search results Get more organic traffic Improve click-through rates Reach the right audience Build..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
+        <a href="/guides/seo-optimization-guide.html" class="nav-item" data-tooltip="@knowcode/doc-builder includes comprehensive SEO (Search Engine Optimization) features that automatically optimize your documentation for search..."><i class="fas fa-file-alt"></i> Seo Optimization Guide</a>
         <a href="/guides/troubleshooting-guide.html" class="nav-item" data-tooltip="This guide helps you resolve common issues when using @knowcode/doc-builder."><i class="fas fa-file-alt"></i> Troubleshooting Guide</a></div></div>
             </nav>
             <div class="resize-handle"></div>