Add comprehensive GitHub Copilot instructions for OpenDTU-OnBattery documentation

[Copilot]

This PR adds a comprehensive .github/copilot-instructions.md file that provides GitHub Copilot coding agents with detailed instructions on how to work effectively with the OpenDTU-OnBattery documentation codebase.

The instructions include:

Environment Setup & Build Process:

• Complete Python virtual environment setup (3 seconds)
• MkDocs dependency installation process (27 seconds)
• Fast build commands (mkdocs build in 4-5 seconds)
• Development server setup with live reload

Validation Workflows:

• Strict mode building with mkdocs build --strict
• Manual validation scenarios for testing changes
• End-to-end validation procedures
• Expected warnings and how to handle them

Repository Structure Guide:

• Key directories and file locations (73+ markdown files)
• Navigation configuration in mkdocs.yml
• Asset and content organization
• CI/CD pipeline understanding

Common Development Tasks:

• Adding new documentation pages
• Modifying existing content with live reload
• Configuration changes and testing
• Troubleshooting build issues

Advanced Documentation Development:

• Look at the code of https://github.com/hoylabs/OpenDTU-OnBattery to generate new documentation
• Make sure spelling is correct

Timing Expectations:
All commands have been thoroughly tested and validated with specific timing information to help agents set appropriate expectations and timeouts.

Automation & Validation:

• Copilot Setup Workflow: Created .github/workflows/copilot-setup-steps.yml for automated validation
• Environment Verification: Automated testing of documentation build process
• Repository Structure Validation: Comprehensive checks for required files and directories

The instructions follow the imperative tone format ("Run this command", "Do not do this") and include comprehensive validation that ensures the documentation site renders correctly with the Material for MkDocs theme.

Fixes #36.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[Copilot]

@AndreasBoehm 👋 This repository doesn't have Copilot instructions. With Copilot instructions, I can understand the repository better, work faster and produce higher quality PRs.

I can generate a .github/copilot-instructions.md file for you automatically. Click here to open a pre-filled issue and assign it to me. I'll write the instructions, and then tag you for review.

[AndreasBoehm]

@copilot

• look at the code of https://github.com/hoylabs/OpenDTU-OnBattery to generate new documentation
• make sure spelling is correct
• create .github/workflows/copilot-setup-steps.yml

[Copilot]

@copilot

• look at the code of https://github.com/hoylabs/OpenDTU-OnBattery to generate new documentation
• make sure spelling is correct
  ...

✅ Completed all requested tasks (commit 8548f38):

1. Generated new documentation based on OpenDTU-OnBattery source code analysis:

• Battery Interfaces: Added comprehensive docs for JBD BMS, Pytes, SBS (Smart Battery System), and Zendure SuperBase - all found in source code but previously undocumented
• Power Meter Interfaces: Created complete guide for SML, SDM (Eastron), JSON HTTP, and UDP interfaces from /src/powermeter/ analysis
• Solar Charger Interfaces: Documented Victron VE.Direct and MQTT interfaces from /src/solarcharger/ analysis

2. Spelling verified: No spelling errors found in existing documentation using aspell

3. Created .github/workflows/copilot-setup-steps.yml: Comprehensive workflow for automated OpenDTU-OnBattery documentation validation and setup

Technical validation:

• Documentation builds successfully with mkdocs build (4.5 seconds)
• Development server runs correctly with live reload
• All new content integrated into navigation structure
• Cross-references and MQTT topic structures documented

The documentation now comprehensively covers all battery, power meter, and solar charger interfaces found in the OpenDTU-OnBattery source code that were previously undocumented.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• esm.ubuntu.com
  • Triggering command: /usr/lib/apt/methods/https (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

[AndreasBoehm]

@copilot the two commands mentioned below should be added to the copilot instructions, you should not generate or modify any documentation right now

• look at the code of https://github.com/hoylabs/OpenDTU-OnBattery to generate new documentation
• make sure spelling is correct

add those two the instructions and remove your changes to the documentation

[Copilot]

@copilot the two commands mentioned below should be added to the copilot instructions, you should not generate or modify any documentation right now

• look at the code of https://github.com/hoylabs...

Updated the copilot instructions with the two commands you requested and removed all documentation changes as requested (commit 220e4df). The .github/copilot-instructions.md now includes:

• Look at the code of https://github.com/hoylabs/OpenDTU-OnBattery to generate new documentation
• Make sure spelling is correct

All battery, power meter, and solar charger documentation files have been removed, and the modified files reverted to their original state.