-
Notifications
You must be signed in to change notification settings - Fork 23
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 installation instructions #255
Comments
The whole “installing” section of the doc is misleading: there is no instruction at all on the standard, simple way to install, only workarounds for edge cases! |
I agree that the whole installing section should be changed. 🙌 But why did we create this page? 🙀Here is some context about the 3rd step that we mention in this issue: it was created for Windows users without admin rights on offline machines. And now what? 🤔Today, I think that offline machines are uncommon and that we can remove this use case to focus on the Windows users without admin rights. Do you agree?
Then, how can we install openfisca on Windows without admin rights? 🤯The easiest installation instructions might differ from one country model to another:
Meanwhile, what can we do?A quick fix to the 3rd step could be to replace it with a title that specifies the country package (France, for now) and the following instructions (extract from an email): You have installed GIT, Python 3.7 and Miniconda. All you need now is initializing conda configuration and downloading openfisca-france library (and dependencies). First check that miniconda is fully installed and that you can call the "conda" command: $ conda It should return some documentation: usage: conda [-h] [-V] command ...
conda is a tool for managing and deploying applications, environments and packages.
... Then, if this first step ended without error, you can configure the conda-forge channel that will provide the libraries with: $ conda config --add channels conda-forge && conda config --set channel_priority strict From this step you can already install openfisca-france model but we advise you to create an isolated environment for your project in two commands (optional):
$ conda create --name openfisca python=3.7
$ conda activate openfisca Finally, you can install openfisca-france: $ conda install openfisca-france You are all set! And you can check the installed libraries with: $ conda list You can also exit the virtual environment at any moment when you don't need to use openfisca-france code with: $ conda deactivate
|
To close this issue:
|
Noting that the presets page links to packages on Anaconda which are very out of date: Is the intention to maintain these packages or remove them from Anaconda and from the documentation? |
The Conda outdated packages would be solved by openfisca/country-template#124. |
Currently, the documentation for installing OpenFisca "On Windows without admin rights" points to a 4 year-old version of https://github.com/openfisca/openfisca-france:
I have the impression the whole section is outdated and misleading, and propose we either:
Thanks to @JasonMorrisSC who filed the issue.
The text was updated successfully, but these errors were encountered: