packaging.python.org
packaging.python.org copied to clipboard
I would like to make a better reference page
Why
Right now I have been trying to make my first pull request and Its been a nightmare. There is a lot I forgot about since I first creating my GitHub account and howto setup git was one of those things. (even though they do have a good guid and I forgotten it was there ) linking me to the relevant info when I created the account (creating my account was all the time I had at that time). Now I would like to add to the Contribution Guide ( If i ever finish my pull request) and easy this pain for someone else by write what I forgoten about and give them links to relevant info.
One thing i learn from my first pull request Is I need to start with a issue to see how to do this correctly and gain experience from great people like @di and @webknjaz who helped and are help me with my first pull request . I also want a issue to list my problem as I come across them so i can document them better.
What
What I would like to do, if you guys don't have better ideas is to make a page to recommend reading
list and change the cotributing page
Most of the work on the Python Packaging User Guide takes place on the project's GitHub repository. To get started, check out the list of open issues and pull requests. If you're planning to write or edit the guide, please read the :ref:
style guide <contributing_style_guide>
.
line "list of open issues and pull requests " to "first Contribution page"
Most of the work on the Python Packaging User Guide takes place on the project's GitHub repository. To get started, check out the Contributions Reference page for recommend reading and tips . If you're planning to write or edit the guide, please read the :ref:
style guide <contributing_style_guide>
.
here is a draft of that page
The python community understand it can be difficult trying to get started with contribution when you don't know the correct search terms and where to look. To help you in this transition we list some valuable resource were you can learn more for each way you like to contribute.
Bellow are the common method to help with contribute and links to help you get to know and use that method.
Make a new Issue request
Make issue are not to bad but we do have a few recommended reads
Make a local copy and modify the text
Before you start contributing it is recommend to start with a tutorial and check out the list of open issues and pull requests. Don't forget to make sure have have git configure correctly
and are going to be using locally do't forget to setup git
Make a pull request
etc.
My Questions and comments
After writing this I feel i seen the header like this somewhere else would this be a problem as long as I keep this in my own words? Is my draft good enough if I keep going? Do you think I should just make a reference page?
I would like to here what other place people would recommend me add to the list
Thank you for any help.