2 commits

Author	SHA1	Message	Date
Julian Pawlowski	d73eda4b2f	git commit -m "feat(docs): add dual Docusaurus sites with custom branding and Giscus integration ... - Split documentation into separate User and Developer sites - Migrated existing docs to proper Docusaurus structure - Added custom Tibber-themed header logos (light + dark mode variants) - Implemented custom color scheme matching integration branding - Hero gradient: Cyan → Dark Cyan → Gold - Removed standard Docusaurus purple/green theme - Integrated Giscus comments system for community collaboration - User docs: Comments enabled on guides, examples, FAQ - User docs: Comments disabled on reference pages (glossary, sensors, troubleshooting) - Developer docs: No comments (GitHub Issues/PRs preferred) - Added categorized sidebars with emoji navigation - Created 8 new placeholder documentation pages - Fixed image paths for baseUrl compatibility (local + GitHub Pages) - Escaped MDX special characters in performance metrics - Added GitHub Actions workflow for automated deployment - Created helper scripts: dev-user, dev-developer, build-all Breaking changes: - Moved /docs/user/*.md to /docs/user/docs/*.md - Moved /docs/development/*.md to /docs/developer/docs/*.md	2025-12-06 01:37:06 +00:00
Julian Pawlowski	df79afc87e	docs: restructure documentation and add AI development disclosure ... Created professional documentation structure: **User Documentation (docs/user/):** - README.md: Documentation hub with quick start guide - Placeholder files for future content migration: * installation.md, configuration.md, sensors.md * services.md, automation-examples.md, troubleshooting.md **Developer Documentation (docs/development/):** - README.md: Comprehensive contributor guide with AI section - setup.md: DevContainer and environment setup - architecture.md: Code structure overview - testing.md: Testing guidelines - coding-guidelines.md: Style guide and critical patterns - release-management.md: Complete release workflow documentation **AI Development Disclosure:** - README.md: "🤖 Development Note" section before license * Honest disclosure about extensive AI assistance * Quality assurance measures mentioned * Invitation for bug reports with positive tone - docs/development/README.md: Detailed AI section * What AI handles (patterns, generation, refactoring) * Benefits (rapid development, consistency) * Limitations (edge cases, complex patterns) * Quality assurance process - CONTRIBUTING.md: Brief AI note with practical tip **Updated:** - README.md: Simplified to landing page with documentation links - CONTRIBUTING.md: Modernized with new docs structure - copilot-instructions.md: Added documentation organization section Impact: Clear separation of user vs. developer documentation following open-source best practices. Transparent about AI-assisted development approach without being defensive. Scalable structure for future growth.	2025-11-09 14:25:27 +00:00