Thanks for your interest in contributing to gemtext-parser!
This guide assumes you are somewhat familiar with Git and have contributed to open source software beforehand.
If you are struggling with anything -- Git, Go, C, Docker, or anything else -- please don't hesitate to send an email to the mailing list (public) or the maintainer (private).
Before sending a patch, please run
composer check-everything which will run
the same tools that are run in CI. You may submit patches that are failing some
checks if you are unsure how to fix them or believe they are false positives.
Email is the primary way to send patches to this project. If you are new to
git send-email, the website https://git-send-email.io/ has a good intro.
Once you have setup SMTP, you should run this command in the directory where
you checked out this project:
git config sendemail.to "~firstname.lastname@example.org"
You don't need to subscribe to the mailing list to participate.
If you need to send a large volume of patches, please push your changes to a
software forge, ideally git.sr.ht, and use
git request-pull to send an email.
If you are not able or willing to use
git send-email, you can you can send
patches via GitHub's "Pull Request" feature. The mirror can be forked and is
monitored by the maintainer.
To discuss features or report bugs, send an email to the mailing list. The GitHub mirror cannot be used for issue tracking.
Please do not directly submit to the issue tracker.
Discussions that affect all ancarda projects can be sent to the Public Inbox.
And of course, any discussion that is better off-the-record - such as security reports - can be sent directly to the maintainer. Feel free to use PGP.