From 72d38b260ffcc507b369a5c53c69d31b56b2a840 Mon Sep 17 00:00:00 2001 From: Jerry Combs Date: Mon, 26 Oct 2026 15:39:19 -0500 Subject: [PATCH] Docs: existing-environments and promotion point at each other; status built Co-Authored-By: Claude Opus 5.5 --- docs/existing-environments.md | 8 +++++++- docs/promotion.md | 4 +++- 2 files changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/existing-environments.md b/docs/existing-environments.md index a639f2c..27124e1 100644 --- a/docs/existing-environments.md +++ b/docs/existing-environments.md @@ -1,6 +1,12 @@ # Taking on existing environments -*Status: decided 2026-10-20; being built on the `driver-environments` branches (core and web).* +*Status: decided 2026-10-20; built (DirXMLDev 0.49.0).* + +This note is about one tree deployed to every environment, with what differs kept in overrides. The +other way, a tree per environment with changes promoted between them, is +[promotion.md](promotion.md); DirXMLDevWeb's +[git-workflow.md](https://github.com/PointBlueTechnology/DirXMLDevWeb/blob/main/docs/git-workflow.md#two-ways-to-keep-environments) +compares the two. The usual case is not a clean start. A customer has a production tree and one or more others (QA, test, dev), each changed by hand over the years: drivers added in one and not the other, the same diff --git a/docs/promotion.md b/docs/promotion.md index b2a8ee7..6c45a3d 100644 --- a/docs/promotion.md +++ b/docs/promotion.md @@ -8,7 +8,9 @@ DirXMLDevWeb's [project-per-environment.md](https://github.com/PointBlueTechnolo The other model, one tree deployed to every environment with `overrides/.properties`, works as before -([existing-environments.md](existing-environments.md)). +([existing-environments.md](existing-environments.md)). DirXMLDevWeb's +[git-workflow.md](https://github.com/PointBlueTechnology/DirXMLDevWeb/blob/main/docs/git-workflow.md#two-ways-to-keep-environments) +compares the two and says when to choose which. The examples use two fictional projects: `acme-qa/tree` (the source) and `acme-prod/tree` (the target).