Skip to content
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.

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

Update documentation:Installation #518

Closed
yeganer opened this issue Mar 10, 2016 · 8 comments
Closed

Update documentation:Installation #518

yeganer opened this issue Mar 10, 2016 · 8 comments

Comments

@yeganer
Copy link
Contributor

yeganer commented Mar 10, 2016

Since several people report having problems with that specific line

conda create -n tardis --file https://raw.githubusercontent.com/tardis-sn/tardis/master/conda-requirements python=2 pip

I suggest changing it to

conda create -n tardis --file conda-requirements python=2 pip

and mention to run that from inside the root of tardis' repository.

There seems to be a problem with using https:// there. The bug seems to be system specific since I didn't encounter it.

@wkerzendorf
Copy link
Member

@yeganer - agreed.

@yeganer
Copy link
Contributor Author

yeganer commented Mar 10, 2016

@wkerzendorf should I do a quick PR?

@wkerzendorf
Copy link
Member

sounds good

@yeganer
Copy link
Contributor Author

yeganer commented Mar 10, 2016

Are we sure we want the part about pip in there?
And on the Installation page we don't even mention cloning git. Is this
still preferred?

Wolfgang Kerzendorf notifications@github.com schrieb am Do., 10. März
2016 um 14:09 Uhr:

sounds good


Reply to this email directly or view it on GitHub
#518 (comment).

@wkerzendorf
Copy link
Member

ditch pip it's nowadays autoinstalled.

@yeganer
Copy link
Contributor Author

yeganer commented Mar 10, 2016

If you look at the current installation page https://tardis.readthedocs.org/en/latest/installation.html you'll notice that the recommended way is to use anaconda and then inside anaconda install tardis with pip install tardis-sn.

If one follows the link to the Development Workflow, the first step is to setup the python environment which links to a page where using virtualenv is explained and anaconda isn't even mentioned.

With that confusing going on, I can understand why we got that many questions asking how to install.

Is the recommended way to install tardis for production still pip? In that case I wouldn't change much on the installation page but improve the "Set up your python environment" part.

yeganer pushed a commit to yeganer/tardis that referenced this issue Mar 10, 2016
On some systems the command to set up the anaconda environment would
fail. A note that this can happen and an alternative command is added to
the configuration.

Resolves: tardis-sn#518
@wkerzendorf
Copy link
Member

whatever recommended means

@wkerzendorf
Copy link
Member

put it on the agenda.

lukeshingles pushed a commit to lukeshingles/tardis that referenced this issue Mar 22, 2016
On some systems the command to set up the anaconda environment would
fail. A note that this can happen and an alternative command is added to
the configuration.

Resolves: tardis-sn#518
ftsamis pushed a commit to ftsamis/tardis that referenced this issue Nov 12, 2016
On some systems the command to set up the anaconda environment would
fail. A note that this can happen and an alternative command is added to
the configuration.

Resolves: tardis-sn#518
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants