README.md

Beethovens Werkstatt Website - Documentation

This folder contains all technical documentation for the Beethovens Werkstatt Jekyll website project.

📋 Documentation Overview

🏗️ Project Status & Architecture

• CURRENT_STATUS.md - Complete project status, features, and file structure
• REORGANIZATION_SUMMARY.md - Recent file organization changes
• DOCS_ORGANIZATION.md - Documentation folder organization

🎨 Design & Styling

• SCSS_ARCHITECTURE.md - Modular SCSS structure and organization
• STYLING_SUMMARY.md - Color schemes, typography, and design decisions
• FONTS_SETUP.md - Font management and local serving setup

🧭 Navigation & Structure

• NAVIGATION_SUMMARY.md - Site navigation and menu structure
• SPA_ISLANDS.md - SPA islands implementation and usage guide

📄 Content Management

• PDF_GENERATION.md - PDF export system for glossary articles (Zenodo archiving)

🚀 Quick Start

1. Project Overview: Start with CURRENT_STATUS.md
2. Development Setup: See main README.md in project root
3. Styling System: Review SCSS_ARCHITECTURE.md

📁 Documentation Structure

docs/
├── README.md                    # This file - documentation index
├── CURRENT_STATUS.md            # Complete project status
├── SCSS_ARCHITECTURE.md         # SCSS modular structure
├── REORGANIZATION_SUMMARY.md    # File organization changes
├── DOCS_ORGANIZATION.md         # Documentation structure changes
├── STYLING_SUMMARY.md           # Design and styling guide
├── FONTS_SETUP.md               # Font management setup
├── NAVIGATION_SUMMARY.md        # Navigation structure
├── SPA_ISLANDS.md               # SPA islands implementation
└── PDF_GENERATION.md            # PDF export for glossary articles

🔄 Maintenance

When adding new features or making changes:

1. Update CURRENT_STATUS.md with new features
2. Document any SCSS changes in SCSS_ARCHITECTURE.md
3. Record major reorganizations in a new summary file
4. Update this index when adding new documentation

🎯 Key Features Documented

• ✅ Hero carousel with auto-advance
• ✅ Modular SCSS architecture
• ✅ Local font serving (Open Sans)
• ✅ Responsive design system
• ✅ Docker development environment
• ✅ Dark footer with partner logos
• ✅ Two-level dropdown navigation

📞 Development Notes

• All documentation uses relative links for easy navigation
• Documentation follows markdown best practices
• Each file includes clear headings and structure
• Status files are updated with each major change

---

Last Updated: July 2, 2025
Project: Beethovens Werkstatt Website
Framework: Jekyll with Docker