Improve Contributing Guidelines

[bevacqua]

Made the contributing guidelines a little more inviting by adding a table of contents and updating some of the wording to be more friendly and less about "this is how we do things".

[ycombinator]

LGTM.

Probably out of scope for this PR but I'd like to rework this section holistically:

That said, a +1 isn't a vote. We keep up on highly commented issues. However, comments are but one of many reasons we might, or might not, work on an issue. A solid write up of your use case is more likely to make your case than a comment that says +10000.

Into something simpler like this:

That said, a +1 isn't a vote. While we keep up on highly +1'd issues, a solid write up of your use case is more likely to make your case than a comment that says +10000.

I can put up a separate PR for my proposed change.

[bevacqua]

@ycombinator Do it!

[cjcenizal]

Maybe replace everything from "GitHub is terrible for conversations" onwards with just:

We prioritize issues according to impact and difficulty, so some issues can continually be overshadowed as more pressing issues arise.

I feel like "we work on what we feel like working on" sounds kind of juvenile, and also inaccurate. Thoughts?

[bevacqua]

Agreed, definitely childish tone to it and kind of unapologetically "not our problem"

[cjcenizal]

LGTM! Just 1 idea.

[cjcenizal]

Great work! LGTM.

[bevacqua]

@cjcenizal Could you do a second pass? 🎉

[cjcenizal]

Looks good but the number of commits doesn't seem reflected in the diff.

[bevacqua]

@cjcenizal Of course. Now just one commit :)

[cjcenizal]

Great improvements! LGTM.

[Bargs]

How do you feel about explicitly saying "use issue reactions for +1s, don't write comments with just a +1"? I'd like this section to focus even more on encouraging well written, thoughtful comments. I'd suggest something like this:

"If an issue is important to you, add a comment with a solid write up of your use case and an explanation of why it's so important. Don't just comment with a 👍 . We seriously appreciate thoughtful comments. By sharing your thoughts we might even be able to come up with creative alternative solutions for your specific problem. If everything you'd like to say has already been said but you'd like to add a token of support, feel free to use the 👍 reaction on the issue itself and the comment which best summarizes your thoughts."

[Bargs]

LGTM

[geekpete]

LGTM

[bevacqua]

Courté