Checklist 'Improvements'
Please refer to the MR, because it became too messy.
To be discussed
Setting up a small Project
-
Organization is Everything
- "...this will be called the top-level folder." => "...this will be called a top-level or root folder."
-
The main thing
- Title: "The Main Thing"
- Link to [modules][python-modules] missing
- Rewrite: "By convention the file containing this starting point is called main.py."
- Paragraph not clear: Each program, be it in one or more files, will need a well-defined starting point. By convention the file containing this starting point is called main.py.
The double underscores __
Surrounding the name of something (files, code elements, …) with double underscores __ usually holds a special meaning: This is important for the internal working of Python itself.
You should not lightly name things with __ and be extra careful when using these things.
With the project folder and the main.py file set up, we are ready to get started.
Edited by Foerster, Thomas