We're revamping the wiki content at the moment.
Because the RecapTime.dev Wiki is not only outdated but also badly needed a content refresh, we'll placing it under maintenace mode during the revamp. Expect major changes into how we organize the wiki, among other things. So, we'll be extending our uttermost apologies if things break here.
- Andrei Jiroh, Open-source Developer/Maintainer and SABDFL
Contributing via email patches¶
We use sourcehut lists to accept merge requests in form of email patches generated by Git. Even through we do use GitHub + GitLab, mishaps on the send-MRs-via-email configuration happen, so we have a backup.
For starters¶
If you never experienced the Git email workflow before, try following the tutorial first, courtesy of sourcehut.
Note that you do not need to sign up to sourcehut's hosted instance as a contributor, although it's help with associating patches to your username.
Setting up¶
# instead of using the squad's meta public inbox, we use project-specific
# mailing list for the wiki
git config sendemail.to "~recaptime-dev/[email protected]"
# since we're using our devel inbox, add te prefix first
git config sendemail.preifx "PATH wiki"
# We want to use the annotate flag every time we send email patches.
# (saves to your global config, so replace with --local when working within
# an ephemeral dev environment)
git config --global sendemail.annotate yes
# We don't want to ask anyone to sign a CLA over email (and it might go wrong),
# so we require anyone to sign-off in accordance to the terms of Linux DCO.
git config format.signOff yes
See also¶
- Mailing list etiquette
- Use plaintext email - In development mailing lists, plaintext is preferred over HTML for reasons like accessibility and security nightmare (or backpain).