Merge pull request #1 from darkpatternsdigital/rename-upstreams-dependencies

Rename upstreams dependencies

Author: mdekrey

README.md

@@ -1,5 +1,9 @@
 # Git shortcuts for implementing the scalable git branching model
 
+The Scalable Git Branching Model has recently been updated; see the new
+terminology in [A scalable Git branching model,
+Revisited](https://dekrey.net/articles/scalable-git-branching-model-revisited/).
+
 ## Prerequisites
 
 - Powershell Core (7+)
@@ -25,34 +29,34 @@ Note: if you have an older version installed, such as .NET 7, you can [install a
 
     Relative paths work, too. To clone and run, you may use the following commands:
 
-        git clone https://github.com/PrincipleStudios/scalable-git-branching-tools.git ../scalable-git-branching-tools
+        git clone https://github.com/DarkPatternsDigital/scalable-git-branching-tools.git ../scalable-git-branching-tools
         ../scalable-git-branching-tools/init.ps1
 
 ## Commands
 
-[`git tool-update`](./docs/tool-update.md)
+[`git tool-update`](./docs/tool-update.md) - Attempts to update these tools
 
-[`git tool-config`](./docs/tool-config.md)
+[`git tool-config`](./docs/tool-config.md) - Configures these tools
 
-[`git new`](./docs/new.md)
+[`git new`](./docs/new.md) - Create a new branch with tracked dependencies
 
-[`git pull-upstream`](./docs/pull-upstream.md)
+[`git pull-deps`](./docs/pull-deps.md) - Pull dependencies into your current branch
 
-[`git show-downstream`](./docs/show-downstream.md)
+[`git show-dependants`](./docs/show-dependants.md) - Shows dependants of the current branch
 
-[`git show-upstream`](./docs/show-upstream.md)
+[`git show-deps`](./docs/show-deps.md) - Shows dependencies of the current branch
 
-[`git add-upstream`](./docs/add-upstream.md)
+[`git add-deps`](./docs/add-deps.md) - Adds one or more dependencies to the current branch
 
-[`git rc`](./docs/rc.md)
+[`git rc`](./docs/rc.md) - Creates a release candidate out of one or more dependencies
 
-[`git rebuild-rc`](./docs/rebuild-rc.md)
+[`git rebuild-rc`](./docs/rebuild-rc.md) - Recreates a release candidate, modifying its dependencies.
 
-[`git verify-updated`](./docs/verify-updated.md)
+[`git verify-updated`](./docs/verify-updated.md) - Verifies if the current branch is up-to-date wit its dependencies
 
-[`git refactor-upstream`](./docs/refactor-upstream.md)
+[`git refactor-deps`](./docs/refactor-deps.md) - Rewrites the dependencies tree as directed
 
-[`git release`](./docs/release.md)
+[`git release`](./docs/release.md) - Releases and cleans up branches
 
 ## Development
 

adr/01-principles.md

@@ -66,4 +66,4 @@ Tools should be written with the following in mind:
 
 [scalable-git]: https://dekrey.net/articles/scaled-git-flow/
 [principle-scalable-git]: https://www.principlestudios.com/article/a-scalable-git-branching-model/
-[principle-tools-branching]: https://principle.tools/branching/
+[principle-tools-branching]: https://principle.tools/branching/

adr/02-code-organization.md

@@ -121,4 +121,4 @@ Under this methodology, the `git new` command would have the basic outline:
 5. Finalize actions
     - `Invoke-FinalizeAction`
         - A single `git push` would set `_upstream` and create the new branch
-        - Checkout the new branch
+        - Checkout the new branch

demos/_setup-existing.ps1

@@ -8,11 +8,11 @@ try {
 
     /git-tools/init.ps1
 
-    git add-upstream main -target feature/add-item-1
-    git add-upstream main -target feature/add-item-2
-    git add-upstream main -target feature/change-existing-item-A
-    git add-upstream main -target feature/change-existing-item-B
-    git add-upstream feature/add-item-1 -target feature/subfeature
+    git add-deps main -target feature/add-item-1
+    git add-deps main -target feature/add-item-2
+    git add-deps main -target feature/change-existing-item-A
+    git add-deps main -target feature/change-existing-item-B
+    git add-deps feature/add-item-1 -target feature/subfeature
 
 } finally {
     Pop-Location

demos/demo-local-cd.ps1

@@ -22,7 +22,7 @@ if ((git branch --show-current) -ne 'feature/PS-1') {
     throw 'Branch name did not match expected';
 }
 
-git rc rc/test -u feature/add-item-1,feature/add-item-2
+git rc rc/test -d feature/add-item-1,feature/add-item-2
 ThrowOnNativeFalure
 
 if ((git branch --show-current) -ne 'feature/PS-1') {

demos/demo-local-with-space.ps1

@@ -25,7 +25,7 @@ if ((git branch --show-current) -ne 'feature/PS-1') {
     throw 'Branch name did not match expected';
 }
 
-git rc rc/test -u feature/add-item-1,feature/add-item-2
+git rc rc/test -d feature/add-item-1,feature/add-item-2
 ThrowOnNativeFalure
 
 if ((git branch --show-current) -ne 'feature/PS-1') {

demos/demo-local.ps1

@@ -22,7 +22,7 @@ if ((git branch --show-current) -ne 'feature/PS-1') {
     throw 'Branch name did not match expected';
 }
 
-git rc rc/test -u feature/add-item-1,feature/add-item-2
+git rc rc/test -d feature/add-item-1,feature/add-item-2
 ThrowOnNativeFalure
 
 if ((git branch --show-current) -ne 'feature/PS-1') {

demos/demo-remote-release.ps1

@@ -13,10 +13,10 @@ git clone ./origin local
 cd local
 /git-tools/init.ps1
 
-git new feature/PS-1 -u feature/add-item-1
+git new feature/PS-1 -d feature/add-item-1
 ThrowOnNativeFalure
 
-git rc rc/test -u feature/subfeature,feature/add-item-2
+git rc rc/test -d feature/subfeature,feature/add-item-2
 ThrowOnNativeFalure
 
 git verify-updated rc/test

demos/demo-remote-without-config.ps1

@@ -24,12 +24,12 @@ if ((git branch --show-current) -ne 'feature/PS-1') {
     throw 'Branch name did not match expected';
 }
 
-$upstreamOfNewFeature = [string[]](git show-upstream)
-if ($upstreamOfNewFeature -notcontains 'main') {
-    throw "Expected main to be upstream of the current branch; found: $(ConvertTo-Json $upstreamOfNewFeature)"
+$dependencyOfNewFeature = [string[]](git show-deps)
+if ($dependencyOfNewFeature -notcontains 'main') {
+    throw "Expected main to be dependency of the current branch; found: $(ConvertTo-Json $dependencyOfNewFeature)"
 }
 
-git rc rc/test -u feature/add-item-1,feature/add-item-2
+git rc rc/test -d feature/add-item-1,feature/add-item-2
 ThrowOnNativeFalure
 
 if ((git branch --show-current) -ne 'feature/PS-1') {

demos/demo-remote.ps1

@@ -13,7 +13,7 @@ git clone ./origin local
 cd local
 /git-tools/init.ps1
 
-git new feature/PS-1 -u feature/add-item-1
+git new feature/PS-1 -d feature/add-item-1
 ThrowOnNativeFalure
 
 if ((git rev-parse origin/feature/add-item-1) -ne (git rev-parse HEAD)) {
@@ -24,19 +24,19 @@ if ((git branch --show-current) -ne 'feature/PS-1') {
     throw 'Branch name did not match expected';
 }
 
-$upstreamOfNewFeature = [string[]](git show-upstream -recurse)
-if ($upstreamOfNewFeature -notcontains 'main') {
-    throw "Expected main to be upstream of the current branch; found: $(ConvertTo-Json $upstreamOfNewFeature)"
+$dependencyOfNewFeature = [string[]](git show-deps -recurse)
+if ($dependencyOfNewFeature -notcontains 'main') {
+    throw "Expected main to be dependency of the current branch; found: $(ConvertTo-Json $dependencyOfNewFeature)"
 }
 
-git rc rc/test -u feature/add-item-1,feature/add-item-2
+git rc rc/test -d feature/add-item-1,feature/add-item-2
 ThrowOnNativeFalure
 
 if ((git branch --show-current) -ne 'feature/PS-1') {
     throw 'Branch name should not have changed';
 }
 
-git pull-upstream rc/test
+git pull-deps rc/test
 ThrowOnNativeFalure
 
 git verify-updated rc/test