From 955aae04d0461cf6d8dad62fa42c76c7e0d243e9 Mon Sep 17 00:00:00 2001 From: StableLlama Date: Sun, 22 Feb 2026 19:41:04 +0100 Subject: [PATCH 1/3] chore(docs): format docs with Prettier --- .github/copilot-instructions.md | 11 +++++++++++ INSTALL.md | 10 ++++++++++ README.md | 19 +++++++++++++++++++ 3 files changed, 40 insertions(+) diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md index 69ea561..f7405d5 100644 --- a/.github/copilot-instructions.md +++ b/.github/copilot-instructions.md @@ -112,6 +112,17 @@ Top-level directories (one level down): - Prefer frontend changes inside features// and keep API calls in services/. - Trust these instructions and only search the repo if something is missing or contradicts these notes. +## Branching and Release Policy + +The repository uses the following branch layout by default: + +- `main` — stable, reflects the last tagged release. Protected and only updated via PRs that have passed CI and reviews. +- `develop` — integration branch for active development. Feature branches should branch from and be merged into `develop`. + +Release and hotfix branches follow `release/vX.Y` and `hotfix/vX.Y.Z` naming; tags should use semantic versions like `v1.2.3`. + +When preparing a new release, create `release/vX.Y` from `develop`, finish testing, then merge into `main` and tag. Merge the release branch back into `develop` afterwards. + ## Chat Tools (LLM Function Calling) To add a new chat tool: diff --git a/INSTALL.md b/INSTALL.md index d25fb21..7ad7313 100644 --- a/INSTALL.md +++ b/INSTALL.md @@ -95,3 +95,13 @@ If you want to modify the code, contribute to the project, or just prefer runnin Then open `http://127.0.0.1:8000` in your browser. For hot-reloading during development, see the Development Workflow section in the `README.md`. + +### Branching notes for contributors + +When contributing, branch from `develop` and open pull requests against `develop` (unless the change is an urgent fix to `main`). + +- Feature branches: `feature/` +- Release branches: `release/vX.Y` (short-lived) +- Hotfix branches: `hotfix/vX.Y.Z` (branch from `main`) + +The `main` branch always reflects the last release; `develop` is the integration branch used for ongoing development. diff --git a/README.md b/README.md index 62db026..9de4b6f 100644 --- a/README.md +++ b/README.md @@ -144,3 +144,22 @@ To maintain visual consistency across your project, you can configure **Project 4. **Additional Information**: Add specific technical parameters or LoRA triggers (e.g., ", dark lighting, no humans"). These details are appended to the generation prompt to ensure your specific generation pipeline rules are followed. When you click "Create Prompt" for an image, the AI will intelligently fuse your image's specific description with your global style and additional parameters into a single, optimized prompt line. + +## Branching Strategy + +This repository uses a simple Git Flow variant to keep releases stable while allowing ongoing development: + +- `main` — the stable branch that always reflects the last tagged release. Protected; merges to `main` should be done only via reviewed PRs and after passing CI. +- `develop` — the integration branch for ongoing development. Feature branches are branched from and merged into `develop`. +- `release/vX.Y` — short-lived release candidate branches created from `develop` when preparing a release. +- `hotfix/vX.Y.Z` — branch from `main` for urgent fixes; merge back into both `main` and `develop`. +- `feature/` — feature branches off `develop`. + +Workflow summary: + +1. Develop features on `feature/*` branches and open PRs against `develop`. +2. When ready, create `release/vX.Y` from `develop`, finalize tests and fixes, then merge into `main` and tag `vX.Y`. +3. Merge the release back into `develop` if any release-specific changes were made. +4. For urgent fixes, create `hotfix/*` from `main`, merge into `main` and `develop`, and tag as appropriate. + +See CONTRIBUTING.md for PR and review requirements. If you prefer a trunk-based model (single-branch), use `main` + short-lived feature branches and tag `main` for releases. From 62e33b214706faf22325acec7a284361859b1f2c Mon Sep 17 00:00:00 2001 From: StableLlama <155108577+StableLlama@users.noreply.github.com> Date: Sun, 22 Feb 2026 20:50:42 +0100 Subject: [PATCH 2/3] Update branches for code quality checks Also run for develop --- .github/workflows/code-quality.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/code-quality.yml b/.github/workflows/code-quality.yml index 8802ff5..3dc3066 100644 --- a/.github/workflows/code-quality.yml +++ b/.github/workflows/code-quality.yml @@ -2,9 +2,9 @@ name: Code Quality Checks on: pull_request: - branches: [ main ] + branches: [ main, develop ] push: - branches: [ main ] + branches: [ main, develop ] jobs: backend-checks: From 248512529ec6395f35bc5d0d2eac8aa17550e4f7 Mon Sep 17 00:00:00 2001 From: StableLlama Date: Sun, 22 Feb 2026 20:57:02 +0100 Subject: [PATCH 3/3] Little update --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 9de4b6f..42f882e 100644 --- a/README.md +++ b/README.md @@ -162,4 +162,4 @@ Workflow summary: 3. Merge the release back into `develop` if any release-specific changes were made. 4. For urgent fixes, create `hotfix/*` from `main`, merge into `main` and `develop`, and tag as appropriate. -See CONTRIBUTING.md for PR and review requirements. If you prefer a trunk-based model (single-branch), use `main` + short-lived feature branches and tag `main` for releases. +See CONTRIBUTING.md for PR and review requirements.