finishing contributor guidelines
parent
87c2491388
commit
7aaa99d917
|
@ -1,5 +1,4 @@
|
||||||
CONTRIBUTING GUIDELINES FOR TTBP
|
# CONTRIBUTING GUIDELINES FOR TTBP
|
||||||
================================
|
|
||||||
|
|
||||||
Hi! Thanks for your interest in working on this project with me!
|
Hi! Thanks for your interest in working on this project with me!
|
||||||
|
|
||||||
|
@ -8,4 +7,56 @@ to; this is because I am not a very experienced developer, and I'm still
|
||||||
learning good practices for facilitating collaborative dev work. I'm open to
|
learning good practices for facilitating collaborative dev work. I'm open to
|
||||||
receiving feedback and discussion even if you're new to writing Python,
|
receiving feedback and discussion even if you're new to writing Python,
|
||||||
programming, or collaborative work in general, but I'd appreciate some extra
|
programming, or collaborative work in general, but I'd appreciate some extra
|
||||||
patience and slack.
|
patience and open communication.
|
||||||
|
|
||||||
|
In general, please try to give me a heads up if you're intending to do work on
|
||||||
|
this codebase before either starting on it or submitting a PR. I'm fairly
|
||||||
|
self-conscious about my code, so I want the best opportunity for respectful
|
||||||
|
engagement, which lets me learn from my mistakes while still providing good
|
||||||
|
software for end users.
|
||||||
|
|
||||||
|
## Contacting Me
|
||||||
|
|
||||||
|
You can send me tildemail at ~endorphant on tilde.town, or catch me in IRC
|
||||||
|
(please send me a PM there, since I don't often monitor the main channel). I
|
||||||
|
might not respond for a few days; this is normal! If you're feeling ignored,
|
||||||
|
please feel free to open an issue in this repo, since that will ping my personal
|
||||||
|
email directly, and we can catch up then.
|
||||||
|
|
||||||
|
## Bugs
|
||||||
|
|
||||||
|
If you find a bug (such as: ttbp crashed while you were running it, an
|
||||||
|
unexpected behavior happened, etc.), please feel free to file an issue with this
|
||||||
|
repo. You can also send me tildemail. Be as descriptive as possible! Describe
|
||||||
|
the last few things that happened, if you remember them, and attach some
|
||||||
|
representation of the bug (copy and paste the terminal output, or take a
|
||||||
|
screenshot).
|
||||||
|
|
||||||
|
If you can fix a bug that you found, please document the bug first by opening an
|
||||||
|
issue, and check in with me before you start working on it. If there's a serious
|
||||||
|
use-breaking bug in the current live code, and I'm unreachable for more than a
|
||||||
|
few days, go ahead and fix it and send a PR, and I'll get to it when I can.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
If there's a new feature you're interested in, please check the list of issues
|
||||||
|
and see if it's been discussed before (including in closed issues). You're
|
||||||
|
welcome to open a new issue if it seems like there isn't any history about your
|
||||||
|
idea, and you can also send me tildemail to ask me about it.
|
||||||
|
|
||||||
|
Please do not start coding new features without discussing your ideas with me
|
||||||
|
first. I have some fairly strong ideas about how ttbp should work, and I don't
|
||||||
|
want anyone to waste their time building new features that don't align with my
|
||||||
|
vision for this project. That said, I'm definitely interested in hearing your
|
||||||
|
ideas, and I'll do my best to communicate my philosophy regardless of if I
|
||||||
|
greenlight your feature or not.
|
||||||
|
|
||||||
|
## Cosmetic Changes
|
||||||
|
|
||||||
|
Please do not open PRs for cosmetic changes to the codebase if we haven't had a
|
||||||
|
prior discussion about it. Cosmetic changes include things like whitespace,
|
||||||
|
commenting/documentation, naming conventions, and other aspects of the codebase
|
||||||
|
that would not affect end users if changed. I am cautiously open to receiving
|
||||||
|
respectful feedback about my general coding style, but I'm not generally
|
||||||
|
interested in having unsolicited style critiqued, or for coding conventions
|
||||||
|
dictated to me. Thank you in advance for your understanding!
|
||||||
|
|
Loading…
Reference in New Issue