phase 1-5

docs_sp/references/branch-definitions.md

@@ -0,0 +1,27 @@
+---
+title: Branch Definitions
+---
+
+# Branch Definitions
+
+Understanding sunnypilot's branching strategy.
+
+## Branch Types
+
+| Branch | Stability | Purpose |
+|--------|----------|---------|
+| Release | Stable | Production-ready releases |
+| Staging | Beta | Pre-release testing |
+| Dev | Alpha | Active development |
+| Main | Development | Latest code, may be unstable |
+
+## Naming Convention
+
+Branches follow the pattern: `<type>-<version>` (e.g., `release-0.9.x`)
+
+## Which Branch Should I Use?
+
+- **Daily driving** → Release branch
+- **Want new features early** → Staging branch
+- **Helping test** → Dev branch
+- **Contributing code** → Main branch

docs_sp/references/recommended-branches.md

@@ -0,0 +1,21 @@
+---
+title: Recommended Branches
+---
+
+# Recommended Branches
+
+Choose the right branch for your needs.
+
+## For Most Users
+
+Use the latest **stable** release branch. This provides the best balance of features and reliability.
+
+## For Testers
+
+Use the **staging** or **dev** branch to test upcoming features and provide feedback.
+
+## For Developers
+
+Use the **main** branch for the latest development code.
+
+See [Branch Definitions](branch-definitions.md) for detailed descriptions of each branch type.