encode/django-rest-framework
1
1
Fork 0
mirror of https://github.com/encode/django-rest-framework.git synced 2025-07-30 18:09:59 +03:00
Code Issues Packages Projects Releases Wiki Activity

Update CONTRIBUTING.md

Browse Source
This commit is contained in:
joyalvarghese 2019-03-25 12:06:03 +05:30 committed by GitHub
parent eff069abf9
commit 19636adfca
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 6 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
CONTRIBUTING.md
View File

@ -1,4 +1,4 @@
#Contributing to the REST framework # Contributing to the REST framework
The world can only really be changed one piece at a time. The art is picking that piece. The world can only really be changed one piece at a time. The art is picking that piece.
@ -6,7 +6,7 @@ The world can only really be changed one piece at a time. The art is picking tha
There are many ways you can contribute to Django REST framework. We'd like it to be a community-led project, so please get involved and help shape the future of the project. There are many ways you can contribute to Django REST framework. We'd like it to be a community-led project, so please get involved and help shape the future of the project.
Community # Community
The most important thing you can do to help push the REST framework project forward is to be actively involved wherever possible. Code contributions are often overvalued as being the primary way to get involved in a project, we don't believe that needs to be the case. The most important thing you can do to help push the REST framework project forward is to be actively involved wherever possible. Code contributions are often overvalued as being the primary way to get involved in a project, we don't believe that needs to be the case.
If you use REST framework, we'd love you to be vocal about your experiences with it - you might consider writing a blog post about using REST framework, or publishing a tutorial about building a project with a particular JavaScript framework. Experiences from beginners can be particularly helpful because you'll be in the best position to assess which bits of REST framework is more difficult to understand and work with. If you use REST framework, we'd love you to be vocal about your experiences with it - you might consider writing a blog post about using REST framework, or publishing a tutorial about building a project with a particular JavaScript framework. Experiences from beginners can be particularly helpful because you'll be in the best position to assess which bits of REST framework is more difficult to understand and work with.
@ -15,17 +15,17 @@ Other really great ways you can help move the community forward include helping
When answering questions make sure to help future contributors find their way around by hyperlinking wherever possible to related threads and tickets, and include backlinks from those items if relevant. When answering questions make sure to help future contributors find their way around by hyperlinking wherever possible to related threads and tickets, and include backlinks from those items if relevant.
#Code of conduct # Code of conduct
Please keep the tone polite & professional. For some users, a discussion on the REST framework mailing list or ticket tracker may be their first engagement with the open source community. First impressions count, so let's try to make everyone feel welcome. Please keep the tone polite & professional. For some users, a discussion on the REST framework mailing list or ticket tracker may be their first engagement with the open source community. First impressions count, so let's try to make everyone feel welcome.
Be mindful in the language you choose. As an example, in an environment that is heavily male-dominated, posts that start 'Hey guys,' can come across as unintentionally exclusive. It's just as easy and more inclusive to use gender-neutral language in those situations. (e.g. 'Hey folks,') Be mindful in the language you choose. As an example, in an environment that is heavily male-dominated, posts that start 'Hey guys,' can come across as unintentionally exclusive. It's just as easy and more inclusive to use gender-neutral language in those situations. (e.g. 'Hey folks,')
The Django code of conduct gives a fuller set of guidelines for participating in community forums. The Django code of conduct gives a fuller set of guidelines for participating in community forums.
#Issues # Issues
It's really helpful if you can make sure to address issues on the correct channel. Usage questions should be directed to the discussion group. Feature requests, bug reports, and other issues should be raised on the GitHub issue tracker. It's really helpful if you can make sure to address issues on the correct channel. Usage questions should be directed to the discussion group. Feature requests, bug reports, and other issues should be raised on the GitHub issue tracker.
#Some tips on good issue reporting: # Some tips on good issue reporting:
When describing issues try to phrase your ticket in terms of the behavior you think needs changing rather than the code you think need changing. When describing issues try to phrase your ticket in terms of the behavior you think needs changing rather than the code you think need changing.
Search the issue list first for related items, and make sure you're running the latest version of REST framework before reporting an issue. Search the issue list first for related items, and make sure you're running the latest version of REST framework before reporting an issue.
@ -46,7 +46,7 @@ To start developing on Django REST framework, clone the repo:
git clone https://github.com/encode/django-rest-framework git clone https://github.com/encode/django-rest-framework
Changes should broadly follow the PEP 8 style conventions, and we recommend you set up your editor to automatically indicate non-conforming styles. Changes should broadly follow the PEP 8 style conventions, and we recommend you set up your editor to automatically indicate non-conforming styles.
#Testing # Testing
To run the tests, clone the repository, and then: To run the tests, clone the repository, and then:
# Setup the virtual environment # Setup the virtual environment