Differences

This shows you the differences between two versions of the page.

--- dev:git [2022/11/23 10:30] – [Configuring SSH] Simplify using alternate key file dyrcona
+++ dev:git [2024/04/09 13:17] (current) – [Bug Fix Release Note Commit Message Tag] stompro
@@ Line 41: / Line 41: @@
   git config user.name "Firstname Lastname"
-  git checkout -b working_branch origin/master
+  git checkout -b working_branch origin/main
   # hack away
   git commit -as # and enter a useful comment
@@ Line 71: / Line 71: @@
   LP#24544: fix the quuxifier
+  Release-Note: Fix the cromulent emulsification of the quuxifier for new installs.
   Signed-off-by: Jane Hacker <jhacker@example.org>
@@ Line 89: / Line 91: @@
   Signed-off-by: Roger Reviewer <roger@example.com>
   Signed-off-by: Chris Committer <chris@example.net>
+===== Bug Fix Release Note Commit Message Tag =====
+For simple bug fixes that can be described with one line, include a line that starts with "**Release-Note:**" that includes the release note text.  This will be grabbed by a script during release creation to speed up creating the release notes.
+==== Use Present Tense ====
+"**Release-Note:**" entries should use present tense; **Add**, **Adds**, **Fixes**, **Updates**, **Removes**.
+If the bug fix needs more explanation, then the docs/RELEASE_NOTES_NEXT/miscellaneous.adoc would be a better location to add those notes.
+Examples:
+  Release-Note: Adds form field labels for patron survey question administration
+  Release-Note: Fixes an issue where auto-renewal events can overwhelm open-ils.trigger drones
+===== Testing Plan =====
+Include a testing plan to ensure that any testers of your patch can quickly understand how to see the original problem and know how to confirm that the fix works.  If a specific system configuration needs to be setup to see the problem in a Concerto Evergreen install, then include those steps.
+It is also acceptable to include the testing plan in the Launchpad ticket, but a note in the commit message such as "See LP bug report for testing plan" can make sure the tester knows where to find it.
 ===== Sign-offs =====
@@ Line 103: / Line 124: @@
 The easiest way to sign-off on one or more commits is to:
-  - Create a new branch based on current master (or, if backporting a fix to a previous release, from the appropriate release branch)
+  - Create a new branch based on current main (or, if backporting a fix to a previous release, from the appropriate release branch)
   - Cherry-pick the commits using the ''-s'' flag
   - **Test** to ensure that everything still works
@@ Line 112: / Line 133: @@
 </code>
-We typically create branches for review that have the pertinent commits at the tip of the branch - that is, the most recent commits. However, if a long-lived branch has merged changes from master over time, you might need to use a tool like ''tig'' to view the changes.
+We typically create branches for review that have the pertinent commits at the tip of the branch - that is, the most recent commits. However, if a long-lived branch has merged changes from main over time, you might need to use a tool like ''tig'' to view the changes.
 For example, to sign-off on two commits with hashes matching ''d28dfa2'' and ''a30de02'' using a local branch name of //openurl-more// and push them to a remote branch in the //working// repo named //user/myname/openurl-signoff//: <code bash>
-# Ensure you have the latest revision of master
+# Ensure you have the latest revision of main
 $ git fetch --all
-$ git checkout -b openurl-more origin/master
+$ git checkout -b openurl-more origin/main
 # or if the intention is to backport to the rel_2_1 release:
 # git checkout -b openurl-more_rel_2_1 origin/rel_2_1
@@ Line 133: / Line 154: @@
 ==== Branches ====
-The tip of Evergreen development is ''master'', while branches that start with ''rel_'' are maintenance branches for release series.  Branches that start with ''tags/'' are legacies of Evergreen's previous Subversion repository, and should not be confused with Git tags.
+The tip of Evergreen development is ''main'', while branches that start with ''rel_'' are maintenance branches for release series.  Branches that start with ''tags/'' are legacies of Evergreen's previous Subversion repository, and should not be confused with Git tags.
 ====== Community Git Repository ======
@@ Line 240: / Line 261: @@
   * Galen Charlton
-  * Thomas Berezansky
-  * Dan Scott
   * Jason Stephenson
@@ Line 257: / Line 276: @@
 <code>
-# git url origin/master
+# git url origin/main
-For sharing origin/master via the remote repo origin:
+For sharing origin/main via the remote repo origin:
 Change remote_name as appropriate in the below commands.
@@ Line 270: / Line 289: @@
 Once you have the remote added you can check out this branch:
-git checkout -b master remote_name/master
+git checkout -b main remote_name/main
 </code>