radicle-heartwood-lfs/radicle-cli/examples/rad-patch.md

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's 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 README.md

Here the instructions are added to the project's README for 1.21 gigawatts and commit the changes to git.

$ git add README.md
$ git commit -v -m "Define power requirements"
[flux-capacitor-power 9dad201] Define power requirements
 1 file changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 README.md

Once the code is ready, we open (or create) a patch with our changes for the project.

$ rad patch open --message "define power requirements" --no-confirm

🌱 Creating patch for heartwood

ok Pushing HEAD to storage...
ok Analyzing remotes...

z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi/master (cdf76ce) <- z6MknSL…StBU8Vi/flux-capacitor-power (9dad201)
1 commit(s) ahead, 0 commit(s) behind

9dad201 Define power requirements


╭─ define power requirements ───────

No description provided.

╰───────────────────────────────────


ok Patch b9bb418c6f504ee91e54c555bdc8fc37b4d9b28b created 🌱

It will now be listed as one of the project's open patches.

$ rad patch

- YOU PROPOSED -

define power requirements b9bb418c6f5 R0 9dad201 (flux-capacitor-power) ahead 1, behind 0
└─ * opened by z6MknSLrJoTcukLrE435hVNQT4JUhbvWLX4kUzqkEStBU8Vi (you) [..]

- OTHERS PROPOSED -

Nothing to show.