updating contrib guidelines

master
Vincent Zeng 2018-01-02 02:01:36 -05:00
parent e8ebe2da6d
commit 5bdaba7331
1 changed files with 25 additions and 13 deletions

View File

@ -9,12 +9,18 @@ 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 open communication. patience and open communication.
In general, please try to give me a heads up if you're intending to do work on In general, please try to give me a heads up if you're intending to work on this
this codebase before either starting on it or submitting a PR. I'm fairly 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 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 engagement, which lets me learn from my mistakes while still providing good
software for end users. software for end users.
If you do not have the skills to contribute to the coding end, I still welcome
your feedback about your experience using ttbp; please feel free to contact me
with anything from vague appreciation to gripes about the interface! I'm
interested in understanding how you feel about this program, and any information
you give me will help me build a smoother tool for everyone!
## Contacting Me ## Contacting Me
You can send me tildemail at ~endorphant on tilde.town, or catch me in IRC You can send me tildemail at ~endorphant on tilde.town, or catch me in IRC
@ -26,11 +32,11 @@ email directly, and we can catch up then.
## Bugs ## Bugs
If you find a bug (such as: ttbp crashed while you were running it, an 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 unexpected behavior happened, some parts of the interface don't line up
repo. You can also send me tildemail. Be as descriptive as possible! Describe correctly, etc.), please feel free to file an issue with this repo. You can also
the last few things that happened, if you remember them, and attach some send me tildemail. Be as descriptive as possible! Describe the last few things
representation of the bug (copy and paste the terminal output, or take a that happened, if you remember them, and attach some representation of the bug
screenshot). (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 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 issue, and check in with me before you start working on it. If there's a serious
@ -39,10 +45,16 @@ few days, go ahead and fix it and send a PR, and I'll get to it when I can.
## Features ## Features
If there's a new feature you're interested in, please check the list of issues Features that I intend to implement are often documented under ["upcoming
and see if it's been discussed before (including in closed issues). You're features"](https://github.com/modgethanc/ttbp/issues?q=is%3Aissue+is%3Aopen+label%3A"upcoming+features")
welcome to open a new issue if it seems like there isn't any history about your in the issue tracker. Feel free to weigh in on any features listed there!
idea, and you can also send me tildemail to ask me about it.
If there's a feature you'd like to see, but it isn't listed as upcoming, please
check the list of issues and see if it's been discussed before (including in
[closed
issues](https://github.com/modgethanc/ttbp/issues?q=is%3Aissue+is%3Aclosed)).
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 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 first. I have some fairly strong ideas about how ttbp should work, and I don't
@ -58,5 +70,5 @@ prior discussion about it. Cosmetic changes include things like whitespace,
commenting/documentation, naming conventions, and other aspects of the codebase commenting/documentation, naming conventions, and other aspects of the codebase
that would not affect end users if changed. I am cautiously open to receiving 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 respectful feedback about my general coding style, but I'm not generally
interested in having unsolicited style critiqued, or for coding conventions interested in unsolicited style critiques, or for coding conventions dictated to
dictated to me. Thank you in advance for your understanding! me. Thank you in advance for your understanding!