swcarpentry / python-novice-gapminder

Plotting and Programming in Python
http://swcarpentry.github.io/python-novice-gapminder/
Other
163 stars 428 forks source link

Running and Quitting - Plotting and Programming in Python #591

Closed jdinklo closed 1 year ago

jdinklo commented 2 years ago

https://swcarpentry.github.io/python-novice-gapminder/01-run-quit/index.html Update in wording

I would like to suggest improvement to the below opening paragraph, found at https://swcarpentry.github.io/python-novice-gapminder/01-run-quit/index.html

"Many software developers will often use an integrated development environment (IDE) or a text editor to create and edit their Python programs which can be executed through the IDE or command line directly. While this is a common approach, we are going to use the Jupyter Notebook via JupyterLab for the remainder of this workshop.”

The first Paragraph in “Running and Quitting“ introduces the concept of IDE and text editors, and then advises “we will use Jupyter Notebook via JupyterLab “. This introduction paragraph could benefit from an explanation (bridging sentence) that explains that Jupyter notebook with JupyterLab is an open-source IDE that can be used with Python and R. The current sentence “While this is a common approach, we are going to use” suggests that the workshop will use an alternate method, other than the two options introduced in the preceding sentence. This could be confusing to those attending.