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.

Sign up for GitHub

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

Jump to bottom

Grammar, clarity and other updates #189

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open

Grammar, clarity and other updates #189

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
73315f5
Update intro (only punctuation and grammar)
mariadelmarq May 9, 2023
0743adc
Tighten episode 2
mariadelmarq May 9, 2023
b0c4017
Replace function example with one more relevant to target audience
mariadelmarq May 9, 2023
76631ab
Merge pull request #1 from datacarpentry/main
mariadelmarq Jul 9, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 8 additions & 9 deletions episodes/01-introduction.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,13 +21,13 @@ exercises: 0

## Introducing the Python programming language

Python is a general purpose programming language. It is an interpreted language,
Python is a general-purpose programming language. It is an interpreted language,
which makes it suitable for rapid development and prototyping of programming segments or complete
small programs.

Python's main advantages:

- Open source software, supported by [Python Software
- Open-source software, supported by [Python Software
Foundation](https://www.python.org/psf/)
- Available on all major platforms (Windows, macOS, Linux)
- It is a good language for new programmers to learn due to its straightforward,
Expand All @@ -43,11 +43,10 @@ before running it. It is the machine code which is executed and produces
results. In a language like C++ your code is translated into machine code and
stored in a separate file, in a process referred to as **compiling** the code.
You then execute the machine code from the file as a separate step. This is
efficient if you intend to run the same machine code many times as you only have
to compile it once and it is very fast to run the compiled machine code.
efficient if you intend to run the same machine code many times as you only compile it once and it is very fast to run the compiled machine code.

On the other hand, if you are experimenting, then your
code will change often and you would have to compile it again every time before
code will change often, and you would have to compile it again every time before
the machine can execute it. This is where **interpreted** languages have the
advantage. You don't need a complete compiled program to "run" what has been
written so far and see the results. This rapid prototyping is helped further by
Expand Down Expand Up @@ -86,11 +85,11 @@ development more interactive. Since its inception, the scope of the project
has expanded to include **Ju**lia, **Pyt**hon, and **R**, so the name was changed to "Jupyter"
as a reference to these core languages. Today, Jupyter supports even more
languages, but we will be using it only for Python code. Specifically, we will
be using **Jupyter notebooks**, which allows us to easily take notes about
be using **Jupyter notebooks**, which allow us to easily take notes about
our analysis and view plots within the same document where we code. This
facilitates sharing and reproducibility of analyses, and the notebook interface
is easily accessible through any web browser. Jupyter notebooks are started
from the terminal using
from the terminal using the following command:

```bash
$ jupyter notebook
Expand Down Expand Up @@ -124,8 +123,8 @@ cell (`In [ ]:`) is created for you automatically.
![](fig/Python_jupyter_8.png){alt='Jupyter\_notebook\_cell'}

When a cell is run, it is given a number along with the corresponding output
cell. If you have a notebook with many cells in it you can run the cells in any
order and also run the same cell many times. The number on the left hand side of
cell. If you have a notebook with many cells in it, you can run the cells in any
order and also run the same cell many times. The number on the left-hand side of
the input cells increments, so you can always tell the order in which they were
run. For example, a cell marked `In [5]:` was the fifth cell run in the sequence.

Expand Down
Loading