python-sprints / python-sprints.github.io

Python Sprints website
https://python-sprints.github.io/
12 stars 55 forks source link

Add section for Windows in pandas set up guide #40

Closed datapythonista closed 6 years ago

datapythonista commented 6 years ago

Pandas set up guide assumes Linux or Mac is being used, and it'd be nice to have a section for Windows users too (mainly on how to install a compiler, not sure if there are other things).

This has been suggested by @jorisvandenbossche in https://github.com/python-sprints/python-sprints.github.io/pull/39#issuecomment-369752490 and previously by @dukebody too.

@Cheukting I think you're probably the right person for the job. ;) Do you have time to take a look at it?

jorisvandenbossche commented 6 years ago

There is a very small section on that in the pandas guide: http://pandas-docs.github.io/pandas-docs-travis/contributing.html#installing-a-c-compiler (with some links), but not very user friendly.

Cheukting commented 6 years ago

Sure I will, will based on the official guide and may be add my own tip (as it was a pain for me to install a compiler)

Cheukting commented 6 years ago

I have checked, basically for Window users they need to install different things (I cannot find a better word as it is so complicated). The best guide is a table in here: https://blogs.msdn.microsoft.com/pythonengineering/2016/04/11/unable-to-find-vcvarsall-bat/

If we can include the table and the links to the download page for those things they need then I think it's fine :-)

Let me know if you want me to commit a file, if so tell me in what format you want.

datapythonista commented 6 years ago

Ideally we want concise instructions on how to set up an environment to contribute to pandas in this document: https://github.com/python-sprints/python-sprints.github.io/blob/master/pandas/guide/source/pandas_setup.rst

I don't have much idea on what is required, so can't really tell how it should fit in the current instructions. But what it comes to my mind is that we replace the current Instructions title by a Instructions for Linux and Mac and at the end we have a Instructions for Windows section.

If that's a good idea (assuming almost everything is different), then we could move the "Create a GitHub account" to the pre-requisits and start each section by the "Get pandas source code", which I assume in Windows people can do it with a right click or something like that. Then, not sure how Anaconda works in Windows, if it's the same from a DOS terminal or what.

Or if you think that everything is mostly the same, just the compiler part, you can just change the section "Compile C code in pandas" to "Compile C code in pandas (Linux and Mac)" and then add a Windows one just for that block.

It's totally up to you. If you leave it as you'd like to have it the day you were installing all this stuff, that would be really great, and appreciated by tens of Windows users during the sprint. :)

Cheukting commented 6 years ago

Sure, I will do it over the weekend. By the way, I don't think Window user can do a git clone in cmd (it won't know the commend git) they will need a git bash. For Anaconda it is more or less the same, they just need to do those commend on an Anaconda Prompt.

I will add instruction for Windows for Git and C compiler section mainly, may add comments for Anaconda.

Cheukting commented 6 years ago

PR #47 sent

math-and-data commented 6 years ago

PR #66 sent - specified where to check the proper Visual Studio marks during the installation.