I've created a rough draft of the prerequisites section. Please feel free to provide feedback on style, grammar, wording or anything else you see fit. Thanks.

@JoshuaAcosta Thanks for getting started on this! I really appreciate you taking the lead on this. I agree with @alexwlchan's comments and a I put a couple of my own. Overall, I think this is a great start and seeing your draft has illuminated some of the challenges of this section for me.

One way we might improve this section would be to back away from assumptions about the reader's system (e.g., that they'll necessarily have x and y but not z installed) and instead check each tool in turn and provide a path forward given the results (e.g., run pip -V and say, here's how to get pip if you need it and here's how to upgrade if you don't). Would you be interested in revising it?

After that, there's some nitpicky formatting issues to deal with, but I think we can work out the overall content a bit before dealing with that. Thanks again for getting started on this!

Thank you very much for the feedback. I'll push the revision with a day or two.

@ddbeck Please feel free to provide some feedback on the revision. I changed the overall content a bit to reflect the flow for each tool you mentioned.

@JoshuaAcosta I like the changes you've made with this revision. Thank you! Here's how I think we should proceed:

• Alex is right about the issues he mentioned in his comment. To be fair, I should've been clearer about that in my original suggestion to you. 😊 If you're willing to update your PR to address that, that would be great.
• As a matter of content, I think this section is looking pretty good, the aforementioned issue aside. There's some things we can do to expand this later (like recapping and previewing at the end of the section), but I think those changes would depend on having the other sections filled out a bit more anyway.
• From here, I think the changes I'd like to see relate to dressing up the formatting. If you have or want to get some more experience with reStructuredText, I can point out some changes to make. Alternatively, I can merge your work and make formatting and style changes myself.

If you'd let me know what you have the interest and time to do, we can go from there. Thanks again for your work on this section!

@ddbeck Thanks for the feedback! I'd like a little more experience with reStructuredText so any pointers or helpful reference material would be appreciated.

@JoshuaAcosta Great! Here's my notes on formatting for you:

• Before making your other changes, I'd suggest taking a look at Sphinx's reStructuredText Primer, which outlines how to format text for reStructuredText/Sphinx. It's similar to the Markdown markup used here on GitHub, but it's got enough differences that you'd probably benefit from skimming that page.
• The first major formatting change would be to promote the pip, setuptools, and wheel parts into sections with section headings. This makes them show up in the table of contents and breaks up the page a bit to help readability.
• The next major formatting change would be to format the sample commands as code samples (enclosing them in double backquotes like this). Most of them are enclosed in double or single quotes in the current PR.
• Lastly, the link to get-pip.py isn't formatted for rST and ought to be fixed as well.

If you have Sphinx installed, you can run make html from the root of the repository, then open build/html/prerequisites.html in a browser to check out your handiwork.

Let me know if you have any questions. I'm happy to help you out on this. Thanks again!

@ddbeck Made the formatting corrections you suggested. Struggled to get the hyperlink formatting right, is it correct? Let me know if anything else could use some work. Thank you for the rST guidance!

@alexwlchan thanks for your help!

@JoshuaAcosta Nice start on the formatting. The link works now. But one of the big areas that needs improvement though is the formatting of the commands. As before, it would be good to enclose them in double backticks so they stand out from the other text. Is that something you'd be comfortable taking on?

If so, I'd suggest getting local builds up and running, in the root of the project:

$ pip install Sphinx   # if you haven't installed Sphinx yet.
$ make html            # or `make.bat html` on Windows

And then open build/html/prerequisites.html to see your handiwork. When you make changes to your file, rerun the make html line to rebuild the output. That way you can test your formatting changes before updating your pull request.

Let me know what you plan to do. Thanks!

@ddbeck I've updated the file with the feedback provided. Please let me know if there are any other changes to be made. Thank you for your patience!

@berkerpeksag thanks for the feedback!