When contributing to another's project, it is common for the contribution to be of many commits and involve a discussion with the project's maintainer. This is supported via Radicle *patches*. Here we give a brief overview for using patches in our hypothetical car scenario. It turns out instructions containing the power requirements were missing from the project. ``` $ git checkout -b flux-capacitor-power $ touch REQUIREMENTS ``` Here the instructions are added to the project's `REQUIREMENTS` for 1.21 gigawatts and committed with git. ``` $ git add REQUIREMENTS $ git commit -v -m "Define power requirements" [flux-capacitor-power 3e674d1] Define power requirements 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 REQUIREMENTS ``` Once the code is ready, we open a patch with our changes. ``` $ rad patch open --message "Define power requirements" --message "See details." master <- z6Mkt67
v4N1tRk/flux-capacitor-power (3e674d1) 1 commit(s) ahead, 0 commit(s) behind 3e674d1 Define power requirements ✓ Patch a07ef7743a32a2e902672ea3526d1db6ee08108a created đŸŒ± To publish your patch to the network, run: rad push ``` It will now be listed as one of the project's open patches. ``` $ rad patch ╭─────────────────────────────────────────────────────────────────────────────────────────╼ │ Define power requirements a07ef77 R0 3e674d1 (flux-capacitor-power) ahead 1, behind 0 │ ├────────────────────────────────────────────────────────────────────────────────────────── │ ● opened by did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk (you) 3 months ago │ ╰─────────────────────────────────────────────────────────────────────────────────────────╯ $ rad patch show a07ef7743a32a2e902672ea3526d1db6ee08108a ╭─────────────────────────────────────────────────────────────────────────────────────────╼ │ Title Define power requirements │ │ Patch a07ef7743a32a2e902672ea3526d1db6ee08108a │ │ Author did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk │ │ Status open │ │ │ │ See details. │ ├────────────────────────────────────────────────────────────────────────────────────────── │ ● opened by did:key:z6Mkt67GdsW7715MEfRuP4pSZxJRJh6kj6Y48WRqVv4N1tRk (you) 3 months ago │ ╰─────────────────────────────────────────────────────────────────────────────────────────╯ commit 3e674d1a1df90807e934f9ae5da2591dd6848a33 Author: radicle Date: Thu Dec 15 17:28:04 2022 +0000 Define power requirements diff --git a/REQUIREMENTS b/REQUIREMENTS new file mode 100644 index 0000000..e69de29 ``` Wait, let's add a README too! Just for fun. ``` $ touch README.md $ git add README.md $ git commit --message "Add README, just for the fun" [flux-capacitor-power 27857ec] Add README, just for the fun 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 README.md $ rad patch update --message "Add README, just for the fun" a07ef7743a32a2e902672ea3526d1db6ee08108a Updating 3e674d1 -> 27857ec 1 commit(s) ahead, 0 commit(s) behind ✓ Patch updated to revision 11483929d8714a92992229f65433e06288f3b760 ``` And let's leave a quick comment for our team: ``` $ rad comment a07ef7743a32a2e902672ea3526d1db6ee08108a --message 'I cannot wait to get back to the 90s!' 18987961eb5e5a8c7fb1fb58f514030d3ea69802 ```