A view into the tools and technology used to build this website.

Documentation

Welcome to the MIJUG .NET workspace documentation. This comprehensive environment combines TypeScript and Jekyll with dual repository architecture for modern web development.

🎯 Quick Start by User Type

👋 New to the Workspace?

  1. Workspace Overview - Start here! Understand the full architecture
  2. Getting Started Guide - Complete setup and first development steps
  3. FrontMatter CMS - Visual content management basics

🔄 Existing Developer?

  1. ESLint 9 Upgrade Guide - Latest linting configuration
  2. Browser Compatibility System - Enhanced testing architecture
  3. Performance Optimization - Build and runtime improvements

📝 Content Creator?

  1. FrontMatter CMS - Visual content management interface
  2. Tags and Categories System - Content organization strategies
  3. Liquid Tags Examples - Advanced Jekyll templating

🚀 Power User/DevOps?

  1. Cache Management - Advanced caching strategies
  2. Browser Management - Automated browser testing infrastructure
  3. Testing Performance Evolution - Performance monitoring systems

📚 Complete Documentation Index

🏗️ Foundation & Setup

Essential for getting started with the workspace

📝 Content Management & Creation

For content creators and Jekyll developers

📊 Diagrams & Visualization

Comprehensive Mermaid diagram integration

🧪 Testing & Quality Assurance

Comprehensive testing strategies and tools

⚡ Performance & Optimization

Advanced performance tuning and monitoring

🔍 Research & Analysis

Technical investigations and explorations

🎯 Recommended Learning Paths

🌱 Beginner Path (New to Workspace)

  1. Workspace Overview - Understand the big picture
  2. Getting Started - Complete setup process
  3. FrontMatter CMS - Content management basics
  4. Mermaid Quick Start - Create your first diagrams
  5. Accessibility Testing - Quality assurance basics

🔄 Migration Path (Existing Users)

  1. ESLint 9 Upgrade Guide - Update linting configuration
  2. Browser Compatibility System - Enhanced testing features
  3. Performance Optimization - Latest optimizations
  4. Testing Performance Evolution - New monitoring tools

📝 Content Creator Path

  1. FrontMatter CMS - Visual interface mastery
  2. Tags and Categories System - Content organization
  3. Liquid Tags Examples - Advanced templating
  4. Mermaid Configuration Guide - Diagram integration
  5. Jekyll Themes Guide - Styling and customization

🚀 Advanced Developer Path

  1. Cache Management - Advanced caching strategies
  2. Browser Management - Testing infrastructure
  3. Mermaid Test Runner - Automated diagram testing
  4. Performance Optimization - Deep optimization
  5. Exploring Limitations of Gitea and Ruby - Technical analysis

🔧 Essential Command Reference

Development Environment

# Start optimized development (TypeScript + Jekyll + drafts)
npm run dev:optimized

# Quick start with performance monitoring
npm run quick:start

# Memory-efficient parallel development
npm run dev:fast

Testing & Quality

# Complete pre-commit validation
npm run precheckin

# Quick smoke tests (< 15 seconds)
npm run test:smoke

# Full accessibility testing
npm run test:a11y

Performance & Optimization

# Performance analysis
npm run perf:check

# Cache optimization
npm run cache:optimize

# Build performance monitoring
npm run perf:build-time

📋 Quick Reference by Category

Category Beginner Intermediate Advanced
Setup Getting Started ESLint 9 Upgrade Performance Optimization
Content FrontMatter CMS Tags & Categories Liquid Tags
Diagrams Mermaid Quick Start Mermaid Examples Mermaid Test Runner
Testing Accessibility Testing Browser Testing Browser Management
Performance Performance Basics Cache Management Testing Evolution

💡 Need Help?

Key Resources

Documentation last updated: November 20, 2025