Teaching Environment for Educators using Python (Beginners) about simplebendingpractice HOT 6 CLOSED

@alfredocarella I'm not a python user, but I can manage my way around a coding system from my experience with different environments. During the install, I had some confusion on which Python version to download (depending on my computer OS/Linux/Windows). I think you should have a link to Python in the 'Installing the package' section (https://github.com/alfredocarella/simplebendingpractice). I was able to install using the:
pip install --user git+https://github.com/alfredocarella/simplebendingpractice but I think a novice user might need some guidance on python install and using the command window.

from simplebendingpractice.

@desgarcia This sounds fine. Improvements to the installation and getting started aspects of the documentation would be helpful. If you can provide some specifics of anything that was confusing I'm sure that would help @alfredocarella make the necessary changes.

from simplebendingpractice.

@moorepants I think that this Issue discusses two things:

• Easiness of use: that might be tackled through a GUI or Jupyter notebooks + Widgets, for example.

• Easiness of installation.

I think that these two, are important but it is not clear to me what are the requirements for JOSE.

from simplebendingpractice.

The only requirement wrt to installation is:

Installation: Does installation proceed as outlined in the documentation? (and documentation is sufficient?)

But it is up to the reviewers to decide on tings beyond this. If the requests are not reasonable, then I'll work with the reviewers and the author to compromise. Sounds like @desgarcia is at least expressing that the documentation is not sufficient. Maybe pointing to some Python "getting started" external resources is sufficient (or not, its up to you). The ease of use aspect will have to be defined by you two.

from simplebendingpractice.

@desgarcia @nicoguaro A link has been added to a tutorial on how to install Python 3 on either Linux, Windows or MacOS.
Installation of the package can be skipped altogether by just using the provided Jupyter notebook hosted on mybinder

from simplebendingpractice.

@alfredocarella I like the added link! I am happy with that addition. I agree, the user can just use the Jupyter notebook - but its also nice and important to introduce some basic steps to new users.

from simplebendingpractice.