Write simple installation instructions for pandas

Question

Write simple installation instructions for pandas

Closed this issue 5 years ago · 13 comments

pandas has a quite complete documentation page with installation instructions:

https://pandas.pydata.org/pandas-docs/stable/install.html

But personally, I don't want users that come to pandas for the first time (and possibly to the whole PyData ecosystem) to find this document and have to use it to get started. I think it makes much more sense to provide a short document with how we think they should set everything up, and then a link to the existing document if they are interested in Advanced installation instructions.

What I think we should provide is a document that explains step by step:

How to get Anaconda
How to set up an environment with pandas
How to import and possibly show the pandas version
Link to the tutorials (we are working on them) and to the advanced installation instructions if they want more options

I'm unsure on whether the instructions should show how to get the environment directly in JupyterLab, show first in a Python terminal and then in JupyterLab, or ignore JupyterLab and just show with the Python terminal.

I think it may make sense to have screenshots and make the installation instructions as easy and visual as possible.

For now they should go into our /doc/ directory, and when we're happy with them, we'll open the PR in pandas.

Answer 1 · 2019-08-11T00:04:46.000Z

I am interested in working on this issue. Can i take this?

Answer 2 · 2019-08-11T02:42:21.000Z

Even I'm interested to work on this., @bhuvanakundumani, can we collaborate on this?

…

On Sun, 11 Aug, 2019, 5:34 AM Bhuvana KA, ***@***.***> wrote: I am interested in working on this issue. Can i take this? — You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub <#114?email_source=notifications&email_token=AK6A2Z2ANIBYSSRTY2JGWPLQD5JR7A5CNFSM4IK2PVXKYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD4AXIUI#issuecomment-520189009>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AK6A2Z3TOSB4ERF3DMWKIQ3QD5JR7ANCNFSM4IK2PVXA> .

Answer 3 · 2019-08-11T12:00:23.000Z

I think the instructions should include JupyterLab/Notebook Environment too.

Answer 4 · 2019-08-12T00:01:34.000Z

Sure @smiaa

Answer 5 · 2019-08-14T15:51:51.000Z

There is a small change here. We'll finally have this page in markdown, and not in rst.

Btw, any ETA for this? I'll have a first draft of the new pandas website soon, and would be nice to have an initial version of this page (we can surely keep iterating on improving it later on).

Answer 6 · 2019-08-14T18:37:17.000Z

This comment is also relevant here: #119 (comment)

Answer 7 · 2019-08-15T00:45:16.000Z

@datapythonista i will work on this over this weekend and try to finish it

Answer 8 · 2019-08-15T03:12:56.000Z

@datapythonista to clarify, do we need to create the markdown pages in python-sprints repo or python-web repo?

…

On Thu, 15 Aug, 2019, 6:15 AM Bhuvana KA, ***@***.***> wrote: @datapythonista <https://github.com/datapythonista> i will work on this over this weekend and try to finish it — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#114?email_source=notifications&email_token=AK6A2Z6GWQ6RNIG3I5URFBDQESRJ5A5CNFSM4IK2PVXKYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD4KQMTA#issuecomment-521471564>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AK6A2ZYLT6G4PEEM4KRJMCDQESRJ5ANCNFSM4IK2PVXA> .

Answer 9 · 2019-08-15T07:29:45.000Z

In pandas-web they already exist, the best is just add the content there.

Answer 10 · 2019-08-16T16:40:33.000Z

@datapythonista - I went through the install.md in the padas-web repo. Should i update the install.md to have installation instructions from terminal? thanks

Answer 11 · 2019-08-17T13:16:14.000Z

To me it makes sense to give installation instructions as simple as possible for new users, and provide other options in a separate page. I think that's less intimidating for very beginner users.

Answer 12 · 2019-08-19T00:20:52.000Z

ok.i understand.Thanks

Answer 13 · 2019-08-24T18:47:37.000Z

@bhuvana I am not able to work on this issue currenly. FYIP.

…

On Mon, 19 Aug, 2019, 5:50 AM Bhuvana KA, ***@***.***> wrote: ok.i understand.Thanks — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#114?email_source=notifications&email_token=AK6A2ZYWL4L2WWI6LZWSVL3QFHROLA5CNFSM4IK2PVXKYY3PNVWWK3TUL52HS4DFVREXG43VMVBW63LNMVXHJKTDN5WW2ZLOORPWSZGOD4RMIUI#issuecomment-522372177>, or mute the thread <https://github.com/notifications/unsubscribe-auth/AK6A2Z5GBORM3MMTFTDWHS3QFHROLANCNFSM4IK2PVXA> .