brightway-lca / brightway-book

📖🌿 Interactive jupyter-book Documentation for Brightway
https://learn.brightway.dev
BSD 3-Clause "New" or "Revised" License
14 stars 5 forks source link

Missing dummy-level instructions for getting started with Python #14

Closed mkvdhulst closed 1 year ago

mkvdhulst commented 1 year ago

In the collected BW2 tutorials, all notebooks either completely skip on the very first first steps of installing python, creating environments and installing packages, or they explain it in a way that is not appropriate for a first-time coder. Often, the reader is referred to external sources, but these are often a bit too generic and their broadness can be overwhelming ("...but what do I need?"). To make the training also accessible to first-time coders, it would be desirable to include clear instructions that also connect to requirements in subsequent notebooks (i.e. instructions to connect to relevant channels, installing required packages etc.).

mkvdhulst commented 1 year ago

Relink images from imgbb to images folder in repo

shirubana commented 1 year ago

I would suggest using this page and giving some attribution to it -- https://pvlib-python.readthedocs.io/en/stable/user_guide/installation.html the clear question and answer of what to do is very easy to follow, with enough information about the conda jupyter options.

shirubana commented 1 year ago

(let me know if you want to assign me this task of moddying it)

michaelweinold commented 1 year ago

The general Brightway setup is now covered on the 'Setup' page of the documentation. The interactive documentation will not require setup.