race2infinity / The-Documentation-Compendium

📢 Various README templates & tips on writing high-quality documentation that people want to read.
5.58k stars 763 forks source link

CONTRIBUTING.md should not be a git tutorial #6

Open meowsbits opened 5 years ago

meowsbits commented 5 years ago

https://github.com/kylelobo/The-Documentation-Compendium/blob/d472f574099bf4fec09c2a843857a9b10dc0a40f/CONTRIBUTING.md

This is tutorial on how to use git. This has nothing to do with real-world project contribution guidelines that would be useful in the context of a working git project. There are far better "How to use git" tutorials out there, and this space should describe either

race2infinity commented 5 years ago

Thanks for the feedback. Would you advocate this format?

  1. Fork it (https://github.com/kylelobo/The-Documentation-Compendium/fork)
  2. Create your feature branch (git checkout -b feature/fooBar)
  3. Commit your changes (git commit -am 'Add some fooBar')
  4. Push to the branch (git push origin feature/fooBar)
  5. Create a new Pull Request
meowsbits commented 5 years ago

Nope. That is also a git tutorial.

cyrilou242 commented 5 years ago

Maybe look for contributing README and pages of Apache projects. They are usually well made. https://github.com/apache/spark/blob/master/CONTRIBUTING.md https://spark.apache.org/contributing.html

LuluNwenyi commented 2 years ago

Hi @kylelobo, I see that there's no longer a CONTRIBUTING.md file. May I ask why, and if I can create a new issue and be assigned to the issue?

race2infinity commented 2 years ago

The CONTRIBUTING.md file is still there