Create a Pull-Request to project speech-rule-engine from user
zorkow/ — the project repository is
Speech Rule Engine from user zorkow.
- Fork
- Fork the project you wish to contribute to. I found
multiple ways of doing this (eventually).
- magit/forge inside emacs:
'cf RET RET
This invokes command M-x forge-fork which prompts for two name
arguments. The meaning of those arguments are somewhat
non-obvious which is why I failed initially. To use it
successfully, set Forge Custom option forge-owned-accounts to
your GitHub user-id — in my case tvraman. Note that this
variable can hold a list of GitHub user-ids that you use.
(setq forge-owned-accounts '(("tvraman")))
With the above in place, go to where you have the source
repository checked out, in my case:
cd ~/sources/zorkow/speech-rule-engine
and open the magit status buffer by executing
M-x magit-status
and execute Emacs command forge-fork — by default
magit/forge binds this to 'cf. The minibuffer shows the
user-id you set up in forge-owned-accounts/ earlier as the
default, press RET to accept the user-id value for both the
fork and remote arguments.
- The above flow works once it's all set-up — note however that
if you are happier to just do this at the shell, you can use
either hub or gh — read the documentation for those
commands. Either way, you now have a copy of the
speech-rule-engine project under your list of GitHub
repositories — in my case at https://github.com/tvraman/speech-rule-engine.
- Clone
- Next, git clone the fork you just created. This is just a regular clone operation, in my case I did:
mkdir -p ~/sources/tvraman; cd ~/sources/tvraman; git clone https://github.com/tvraman/speech-rule-engine
- Create Your Changes
- Follow the steps from the earlier tutorials
to do your work, i.e., creating a feature-branch to hold your
changes,etc. Note that all this work is being done in your fork,
i.e., in this example, within ~/sources/tvraman/speech-rule-engine.
- Create Pull Request
- When ready, open the magit-status buffer
for your fork, and create the pull-request using magit/forge —
in the magit status buffer, type 'cp.
- Uploading The Pull Request
- Now, you need to send the
pull-request to the author of the project you are contributing to
— this is again one of those steps that all the docs talk about
pushing a button on GitHub.com. The easiest means I found to do
this was via command-line tool hub:
cd ~/sources/tvraman/speech-rule-engine; hub pull-request
Assuming you have emacsclient configured as your EDITOR, this opens
a standard commit-like message buffer that lets you complete the
action. Result: a new, shiny pull-request shows up in the target
project — in this case in zorkow/speech-rule-engine.
