Apply 1 suggestion(s) to 1 file(s)

README.md

@@ -13,8 +13,9 @@ Roles:
   * E.g. look up in in [verify/.sops.yaml](verify/.sops.yaml)
 
 ## 1a. Onboarding: [New User]: create and add a gpg key
-- create a branch titled `add_pubkey_<firstname>-<lastname>` <!-- Review from Bas: Please make sure it's clear to the user that you mean this repo. -->
-  - e.g. `git branch add_pubkey_test-user`
+- Within this repository, create a branch titled `add_pubkey_[firstname]-[lastname]`. <!-- NOTE: Validation Hack: User will not be able to mistakenly create this literal branch, as the unpermitted chars '[' will prevent the branch from being created: "Branch name cannot contain '['" as per https://git-scm.com/docs/git-check-ref-format. I.e. it's a dirty hack to get some server-side(?) validation ;-) --> 
+  - Web: e.g. The following link can be used to create a branch: [https://git.dev-at.de/smardigo-hetzner/communication-keys/-/branches/new?branch_name=add_pubkey_[firstname]-[lastname]]()
+  - CLI: e.g. `git branch add_pubkey_[firstname]-[lastname]`
   - Note: no strict naming convention for the branch, it's strictly a Human-in-the-Loop process
 - please follow steps 1-13 at the following link: https://docs.github.com/en/authentication/managing-commit-signature-verification/generating-a-new-gpg-key
   - CAVEAT: step 14 is not necessary, as it is specific to a GitHub account