Skip to content

Commit 56db613

Browse files
committed
Update docs
1 parent ad904f6 commit 56db613

2 files changed

Lines changed: 3 additions & 19 deletions

File tree

AI_CONTEXT.md

Lines changed: 2 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -59,23 +59,7 @@ When creating Python or Shell scripts for this project:
5959
## 5. Deployment Logic
6060

6161
* The site is built via **GitHub Actions**.
62-
* We must push changes from the `docs_site/` directory to trigger a build.
63-
* **CNAME:** Ensure `docs/CNAME` exists and contains `www.evishome.com`.
64-
65-
## 6. Project History & Architectural Decisions (ADRs)
66-
67-
*This section captures 'Silent Knowledge' and lessons learned.*
6862

69-
1. **ADR-001: Detached Documentation:**
70-
* **Decision:** We use two separate Git repositories. The root `/config` is local-only to prevent accidental secret leakage. Only `docs_site/` is pushed to GitHub.
71-
72-
2. **ADR-002: Dashboard Generation via Python:**
73-
* **Failure:** Using LLMs to "rewrite" JSON dashboards often results in broken YAML or single-line dumps.
74-
* **Decision:** We rely on `ag_regenerate_dashboards.py`. This script forces `default_flow_style=False` to ensure readable, block-style YAML output. It also enforces privacy redaction programmatically.
75-
76-
3. **ADR-003: Samba & Git Ownership:**
77-
* **Issue:** Windows clients accessing HA via Samba see "Dubious Ownership" errors because the files are owned by `root` on the server.
78-
* **Fix:** We enforce `git config --global --add safe.directory '*'` on all dev machines.
63+
* We must push changes from the `docs_site/` directory to trigger a build.
7964

80-
4. **ADR-004: MkDocs Material Features:**
81-
* **Decision:** We explicitly enable `navigation.indexes` (folders act as pages) and `admonition` extensions to support high-quality CMDB layouts.
65+
* **CNAME:** Ensure `docs/CNAME` exists and contains `www.evishome.com`.

docs/system_manual/setup_guide.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ This project automates the documentation of a Home Assistant Smart Home and Home
1515

1616
---
1717

18-
# PART A: One-Time Initialization (The Genesis)
18+
## PART A: One-Time Initialization (The Genesis)
1919

2020
**⚠️ STOP:** Only perform these steps if you are setting up the system **for the very first time** on a fresh Home Assistant server. If the system already exists and you just want to connect a new laptop, skip to **PART B**.
2121

0 commit comments

Comments
 (0)