fix: correct documentation URLs and heading visibility issues

Author: Shorzinator

README.md

@@ -2,8 +2,8 @@
 
 # codebrief
 
-[![CI](https://github.com/Shorzinator/codebrief/workflows/codebrief%20CI/badge.svg)](https://github.com/Shorzinator/codebrief/actions)
-[![Coverage](https://img.shields.io/badge/coverage-77%25-yellow)](https://github.com/Shorzinator/codebrief)
+[![CI](https://github.com/Shorzinator/CodeBrief/workflows/CodeBrief%20CI/badge.svg)](https://github.com/Shorzinator/CodeBrief/actions)
+[![Coverage](https://img.shields.io/badge/coverage-77%25-yellow)](https://github.com/Shorzinator/CodeBrief)
 [![Python](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![Code style: Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
@@ -142,16 +142,16 @@ global_exclude_patterns = [
 
 ## Documentation
 
-**[Live Documentation Website](https://shorzinator.github.io/codebrief/)**
+**[Live Documentation Website](https://shorzinator.github.io/CodeBrief/)**
 
 Comprehensive documentation including:
 
-- **[Getting Started](https://shorzinator.github.io/codebrief/getting-started/installation/)** - Installation and basic usage
-- **[CLI Commands](https://shorzinator.github.io/codebrief/user-guide/cli-commands/)** - Complete command reference
-- **[Configuration](https://shorzinator.github.io/codebrief/getting-started/configuration/)** - Advanced configuration options
-- **[API Reference](https://shorzinator.github.io/codebrief/reference/)** - Detailed API documentation
-- **[Examples](https://shorzinator.github.io/codebrief/examples/)** - Real-world usage examples
-- **[Tutorials](https://shorzinator.github.io/codebrief/tutorials/)** - Step-by-step guides
+- **[Getting Started](https://shorzinator.github.io/CodeBrief/getting-started/installation/)** - Installation and basic usage
+- **[CLI Commands](https://shorzinator.github.io/CodeBrief/user-guide/cli-commands/)** - Complete command reference
+- **[Configuration](https://shorzinator.github.io/CodeBrief/getting-started/configuration/)** - Advanced configuration options
+- **[API Reference](https://shorzinator.github.io/CodeBrief/reference/)** - Detailed API documentation
+- **[Examples](https://shorzinator.github.io/CodeBrief/examples/)** - Real-world usage examples
+- **[Tutorials](https://shorzinator.github.io/CodeBrief/tutorials/)** - Step-by-step guides
 
 ## Development
 
@@ -165,8 +165,8 @@ Comprehensive documentation including:
 
 ```bash
 # Clone the repository
-git clone https://github.com/Shorzinator/codebrief.git
-cd codebrief
+git clone https://github.com/Shorzinator/CodeBrief.git
+cd CodeBrief
 
 # Install dependencies
 poetry install --with dev
@@ -226,7 +226,7 @@ codebrief is actively developed and maintained. Current status:
 
 <div align="center">
 
-**[Documentation](https://shorzinator.github.io/codebrief/) • [Issues](https://github.com/Shorzinator/codebrief/issues) • [Discussions](https://shorzinator.github.io/codebrief/community/)**
+**[Documentation](https://shorzinator.github.io/CodeBrief/) • [Issues](https://github.com/Shorzinator/CodeBrief/issues) • [Discussions](https://shorzinator.github.io/CodeBrief/community/)**
 
 Made for the developer community
 

docs/javascripts/extra.js

@@ -1,22 +1,48 @@
 // Custom JavaScript for codebrief Documentation
 
+// Ensure headings are visible immediately
+document.documentElement.style.setProperty('--heading-visibility', 'visible');
+
 // Wait for DOM to be fully loaded
 document.addEventListener('DOMContentLoaded', function() {
-
-    // Initialize all features
-    initSmoothScrolling();
-    initCodeCopyEnhancements();
-    initScrollToTop();
-    initProgressIndicator();
-    initSearchEnhancements();
-    initCardAnimations();
-    initTableEnhancements();
-    initThemeTransitions();
-    initLEDEffects();
-
-    console.log('codebrief documentation enhanced! 🚀');
+    // Ensure all headings are visible first
+    ensureHeadingVisibility();
+
+    // Initialize all features with a small delay to prevent rendering issues
+    setTimeout(() => {
+        initSmoothScrolling();
+        initCodeCopyEnhancements();
+        initScrollToTop();
+        initProgressIndicator();
+        initSearchEnhancements();
+        initCardAnimations();
+        initTableEnhancements();
+        initThemeTransitions();
+
+        // Initialize LED effects last to prevent interference
+        setTimeout(() => {
+            initLEDEffects();
+        }, 100);
+
+        console.log('codebrief documentation enhanced! 🚀');
+    }, 50);
 });
 
+/**
+ * Ensure headings are always visible
+ */
+function ensureHeadingVisibility() {
+    const headings = document.querySelectorAll('h1, h2, h3, h4, h5, h6');
+    headings.forEach(heading => {
+        heading.style.opacity = '1';
+        heading.style.visibility = 'visible';
+        // Prevent text-fill-color issues during load
+        if (getComputedStyle(heading).webkitTextFillColor === 'rgba(0, 0, 0, 0)') {
+            heading.style.webkitTextFillColor = 'initial';
+        }
+    });
+}
+
 /**
  * Enhanced smooth scrolling for anchor links
  */

docs/stylesheets/extra.css

@@ -1,5 +1,17 @@
 /* Custom CSS for codebrief Documentation */
 
+/* Prevent flash of invisible content - ensure headings are always visible */
+.md-typeset h1,
+.md-typeset h2,
+.md-typeset h3,
+.md-typeset h4,
+.md-typeset h5,
+.md-typeset h6 {
+  opacity: 1 !important;
+  visibility: visible !important;
+  -webkit-text-fill-color: initial !important;
+}
+
 /* Root variables for consistent theming */
 :root {
   --cc-primary: #2563eb;
@@ -29,6 +41,17 @@
   font-size: 3rem;
   line-height: 1.1;
   margin-bottom: 1.5rem;
+  /* Ensure visibility during load */
+  opacity: 1 !important;
+  visibility: visible !important;
+}
+
+/* Fallback for browsers that don't support background-clip */
+@supports not (-webkit-background-clip: text) {
+  .md-typeset h1:first-child {
+    -webkit-text-fill-color: initial !important;
+    color: var(--cc-primary-dark);
+  }
 }
 
 /* Hero section styling */