Skip to content

Add CONTRIBUTION guide #205

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
gribok wants to merge 6 commits into from
Closed

Add CONTRIBUTION guide #205

Changes from 3 commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
8f248d1
first version of contrib-guide ExpDev07/coronavirus-tracker-api#169
gribok Mar 26, 2020
373fdc7
fix refs in contrib-guide
gribok Mar 26, 2020
ebbd19f
add more refs to contrib guide
gribok Mar 26, 2020
6daffde
Merge branch 'master' of https://github.com/ExpDev07/coronavirus-trac…
gribok Mar 29, 2020
b3ac508
Add formatting to styleguide
gribok Mar 29, 2020
d56cb32
Add test coverage measuring. See ExpDev07/coronavirus-tracker-api#207
gribok Mar 29, 2020
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 35 additions & 0 deletions CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# Contribution to Coronavirus Tracker API

First off, thanks for taking the time to contribute!
Every commit supports the open source ecosystem in case of [COVID-19](https://en.wikipedia.org/wiki/2019%E2%80%9320_coronavirus_pandemic).

## Testing

We have a handful of unit tests to cover most of functions.
Please write new test cases for new code you create.

## Submitting changes

* If you're unable to find an open issue, [open a new one](https://github.com/ExpDev07/coronavirus-tracker-api/issues/new). Be sure to include a **title and clear description**, as much relevant information as possible
* Open a new [GitHub Pull Request to coronavirus-tracker-api](https://github.com/ExpDev07/coronavirus-tracker-api/pulls) with a clear list of what you've done (read more about [pull requests](http://help.github.com/pull-requests/)). Include the relevant issue number if applicable.
* We will love you forever if you include unit tests. We can always use more test coverage

## Your First Code Contribution

Unsure where to begin contributing to coronavirus-tracker-api ? You can start by looking through these issues labels:

* [Enhancement issues](https://github.com/ExpDev07/coronavirus-tracker-api/labels/enhancement) - issues for new feature or request
* [Help wanted issues](https://github.com/ExpDev07/coronavirus-tracker-api/labels/help%20wanted) - extra attention is needed
* [Documentation issues](https://github.com/ExpDev07/coronavirus-tracker-api/labels/documentation) - improvements or additions to documentation

## Styleguide

Please follow [PEP8](https://www.python.org/dev/peps/pep-0008/) guide.
See [Running Test](./README.md#running-tests) and [Linting](./README.md#linting) for further instructions.

Copy link
Collaborator

@Kilo59 Kilo59 Mar 27, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we add a step here about running the formatter?
pipenv run fmt or make fmt or black . -l 120

Copy link
Contributor Author

@gribok gribok Mar 29, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for feedback. Added make ftm to styleguide section.


We encourage you to pitch in and join the [Coronavirus Tracker API Team](https://github.com/ExpDev07/coronavirus-tracker-api#contributors-)!

Thanks! :heart: :heart: :heart:

[Coronavirus Tracker API Team](https://github.com/ExpDev07/coronavirus-tracker-api#contributors-)