You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: AI_CONTEXT.md
+2-18Lines changed: 2 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -59,23 +59,7 @@ When creating Python or Shell scripts for this project:
59
59
## 5. Deployment Logic
60
60
61
61
* 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.*
68
62
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.
79
64
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`.
Copy file name to clipboardExpand all lines: docs/system_manual/setup_guide.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,7 +15,7 @@ This project automates the documentation of a Home Assistant Smart Home and Home
15
15
16
16
---
17
17
18
-
# PART A: One-Time Initialization (The Genesis)
18
+
##PART A: One-Time Initialization (The Genesis)
19
19
20
20
**⚠️ 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**.
0 commit comments