From 149fa9f5f3c74058aa023692d45d234f93d560b5 Mon Sep 17 00:00:00 2001 From: tshiya731 Date: Tue, 7 Jan 2025 11:28:19 +0100 Subject: [PATCH 1/8] bug form remove --- book/01/Exercises/bug_report.md | 9 --------- book/02/Exercises/bug_report.md | 10 ---------- book/03/Exercises/bug_report.md | 9 --------- book/04/Exercises/bug_report.md | 9 --------- book/05/Exercises/bug_report.md | 9 --------- book/06/Exercises/bug_report.md | 9 --------- book/07/Exercises/bug_report.md | 9 --------- book/_toc.yml | 9 +-------- 8 files changed, 1 insertion(+), 72 deletions(-) delete mode 100644 book/01/Exercises/bug_report.md delete mode 100644 book/02/Exercises/bug_report.md delete mode 100644 book/03/Exercises/bug_report.md delete mode 100644 book/04/Exercises/bug_report.md delete mode 100644 book/05/Exercises/bug_report.md delete mode 100644 book/06/Exercises/bug_report.md delete mode 100644 book/07/Exercises/bug_report.md diff --git a/book/01/Exercises/bug_report.md b/book/01/Exercises/bug_report.md deleted file mode 100644 index 96777b7..0000000 --- a/book/01/Exercises/bug_report.md +++ /dev/null @@ -1,9 +0,0 @@ -# Bug Report Issue Form (optional) - -Thank you for taking the time to provide feedback on the course. Your bug reports are valuable in helping us identify and address any issues to improve the course for future students. - -If desired, please fill out the following form to report any bugs or technical issues you encountered during this module. Your answers will be kept confidential unless you specify otherwise. - -Please note that questions marked with a red asterisk (*) are mandatory. - - \ No newline at end of file diff --git a/book/02/Exercises/bug_report.md b/book/02/Exercises/bug_report.md deleted file mode 100644 index 20cb070..0000000 --- a/book/02/Exercises/bug_report.md +++ /dev/null @@ -1,10 +0,0 @@ -# Bug Report Issue Form (optional) - -Thank you for taking the time to provide feedback on the course. Your bug reports are valuable in helping us identify and address any issues to improve the course for future students. - -If desired, please fill out the following form to report any bugs or technical issues you encountered during this module. Your answers will be kept confidential unless you specify otherwise. - -Please note that questions marked with a red asterisk (*) are mandatory. - - - diff --git a/book/03/Exercises/bug_report.md b/book/03/Exercises/bug_report.md deleted file mode 100644 index 71d2926..0000000 --- a/book/03/Exercises/bug_report.md +++ /dev/null @@ -1,9 +0,0 @@ -# Bug Report Issue Form (optional) - -Thank you for taking the time to provide feedback on the course. Your bug reports are valuable in helping us identify and address any issues to improve the course for future students. - -If desired, please fill out the following form to report any bugs or technical issues you encountered during this module. Your answers will be kept confidential unless you specify otherwise. - -Please note that questions marked with a red asterisk (*) are mandatory. - - diff --git a/book/04/Exercises/bug_report.md b/book/04/Exercises/bug_report.md deleted file mode 100644 index 2f3184e..0000000 --- a/book/04/Exercises/bug_report.md +++ /dev/null @@ -1,9 +0,0 @@ -# Bug Report Issue Form (optional) - -Thank you for taking the time to provide feedback on the course. Your bug reports are valuable in helping us identify and address any issues to improve the course for future students. - -If desired, please fill out the following form to report any bugs or technical issues you encountered during this module. Your answers will be kept confidential unless you specify otherwise. - -Please note that questions marked with a red asterisk (*) are mandatory. - - diff --git a/book/05/Exercises/bug_report.md b/book/05/Exercises/bug_report.md deleted file mode 100644 index 5b34b31..0000000 --- a/book/05/Exercises/bug_report.md +++ /dev/null @@ -1,9 +0,0 @@ -# Bug Report Issue Form (optional) - -Thank you for taking the time to provide feedback on the course. Your bug reports are valuable in helping us identify and address any issues to improve the course for future students. - -If desired, please fill out the following form to report any bugs or technical issues you encountered during this module. Your answers will be kept confidential unless you specify otherwise. - -Please note that questions marked with a red asterisk (*) are mandatory. - - diff --git a/book/06/Exercises/bug_report.md b/book/06/Exercises/bug_report.md deleted file mode 100644 index 8344825..0000000 --- a/book/06/Exercises/bug_report.md +++ /dev/null @@ -1,9 +0,0 @@ -# Bug Report Issue Form (optional) - -Thank you for taking the time to provide feedback on the course. Your bug reports are valuable in helping us identify and address any issues to improve the course for future students. - -If desired, please fill out the following form to report any bugs or technical issues you encountered during this module. Your answers will be kept confidential unless you specify otherwise. - -Please note that questions marked with a red asterisk (*) are mandatory. - - diff --git a/book/07/Exercises/bug_report.md b/book/07/Exercises/bug_report.md deleted file mode 100644 index 7ca2f9b..0000000 --- a/book/07/Exercises/bug_report.md +++ /dev/null @@ -1,9 +0,0 @@ -# Bug Report Issue Form (optional) - -Thank you for taking the time to provide feedback on the course. Your bug reports are valuable in helping us identify and address any issues to improve the course for future students. - -If desired, please fill out the following form to report any bugs or technical issues you encountered during this module. Your answers will be kept confidential unless you specify otherwise. - -Please note that questions marked with a red asterisk (*) are mandatory. - - diff --git a/book/_toc.yml b/book/_toc.yml index 7675181..b83d3ca 100644 --- a/book/_toc.yml +++ b/book/_toc.yml @@ -16,32 +16,25 @@ parts: - file: 01/Theory/01.ipynb sections: - file: 01/Exercises/01.ipynb - - file: 01/Exercises/bug_report.md - file: 02/Theory/01.ipynb sections: - file: 02/Exercises/01.ipynb - - file: 02/Exercises/bug_report.md - file: 03/Theory/01.ipynb sections: - - file: 03/Exercises/01.ipynb - - file: 03/Exercises/bug_report.md + - file: 03/Exercises/01.ipynb - file: 04/Theory/01.ipynb sections: - file: 04/Exercises/01.ipynb - - file: 04/Exercises/bug_report.md - file: 05/Theory/01.ipynb sections: - file: 05/Exercises/01.ipynb - file: 05/Exercises/02.ipynb - - file: 05/Exercises/bug_report.md - file: 06/Theory/01.ipynb sections: - file: 06/Exercises/01.ipynb - - file: 06/Exercises/bug_report.md - file: 07/Theory/01.ipynb sections: - file: 07/Exercises/01.ipynb - - file: 07/Exercises/bug_report.md - file: 08/sympy title: 8. SymPy - file: 09/intro.md From 59530bced42fb7715b55bda066b9aaee57279a59 Mon Sep 17 00:00:00 2001 From: tshiya731 Date: Fri, 10 Jan 2025 13:37:27 +0100 Subject: [PATCH 2/8] reportbug-setup --- book/_config.yml | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/book/_config.yml b/book/_config.yml index b20ab49..7ccc258 100644 --- a/book/_config.yml +++ b/book/_config.yml @@ -32,8 +32,9 @@ html: favicon : "figures/favicon.ico" google_analytics_id: G-8FZWSB5TQP home_page_in_navbar: false - use_issues_button: false - use_repository_button: false + use_issues_button: true + use_repository_button: true + use_edit_page_button: true # announcement: "⚠️ This is not the final version of the book! The new version will be ready by July 1.⚠️" extra_navbar: |
From a044ce6ad0fb59133cffff605b33eb73d3ad7782 Mon Sep 17 00:00:00 2001 From: Robert Lanzafame Date: Sat, 11 Jan 2025 04:35:51 +0100 Subject: [PATCH 3/8] intro comments and filename formatting --- book/Intro_in_ToC.md | 2 ++ book/_toc.yml | 2 +- book/intro.md | 4 +++- book/intro_text.md | 2 ++ 4 files changed, 8 insertions(+), 2 deletions(-) diff --git a/book/Intro_in_ToC.md b/book/Intro_in_ToC.md index b135c52..9f5842d 100644 --- a/book/Intro_in_ToC.md +++ b/book/Intro_in_ToC.md @@ -1,4 +1,6 @@ # Python for Engineers +% The content of this page is defined in a separate file in order to have it appear in the home page of the book (not listed in ToC), as well as to have it listed directly in the ToC in the Introduction Part + ```{include} ./intro_text.md ``` \ No newline at end of file diff --git a/book/_toc.yml b/book/_toc.yml index b83d3ca..0f60a71 100644 --- a/book/_toc.yml +++ b/book/_toc.yml @@ -6,7 +6,7 @@ root: intro parts: - caption: Introduction chapters: - - file: Intro_in_ToC.md + - file: intro_in_toc.md title: Course Overview - file: Python_intro.md title: Programming and Python diff --git a/book/intro.md b/book/intro.md index b135c52..431313b 100644 --- a/book/intro.md +++ b/book/intro.md @@ -1,4 +1,6 @@ # Python for Engineers +% The content of this page is defined in a separate file in order to have it appear in the home page of the book (not listed in ToC), as well as to have it listed directly in the ToC in the Introduction Part + ```{include} ./intro_text.md -``` \ No newline at end of file +``` diff --git a/book/intro_text.md b/book/intro_text.md index 143de0c..3d924aa 100644 --- a/book/intro_text.md +++ b/book/intro_text.md @@ -1,3 +1,5 @@ +% The content of this page is included in two places: the home page of the book intro.md (not listed in ToC), as well as in the Introduction Part of the book Intro_in_ToC.md (listed in ToC) + Welcome to **Python for Engineers**. We're excited to have you join us in this self-paced online course, which is designed to improve your Python skills as well as your understanding of computer programming---especially for applications in engineering and the applied geosciences. Believe it or not, as long as you are using a modern internet browser, you can take complete this course without installing a single piece of extra software! From 6c2f6ecf0c8f8d05a00e203b7617ece4b9a446e8 Mon Sep 17 00:00:00 2001 From: Robert Lanzafame Date: Sat, 11 Jan 2025 04:39:06 +0100 Subject: [PATCH 4/8] intro text: adjust additional resources info --- book/intro_text.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/book/intro_text.md b/book/intro_text.md index 3d924aa..af48ccd 100644 --- a/book/intro_text.md +++ b/book/intro_text.md @@ -1,14 +1,13 @@ % The content of this page is included in two places: the home page of the book intro.md (not listed in ToC), as well as in the Introduction Part of the book Intro_in_ToC.md (listed in ToC) Welcome to **Python for Engineers**. We're excited to have you join us in this self-paced online course, which is designed to improve your Python skills as well as your understanding of computer programming---especially for applications in engineering and the applied geosciences. Believe it or not, as long as you are using a modern internet browser, you can take complete this course without installing a single piece of extra software! - ```{admonition} What do we mean by "engineers"? :class: dropdown This course was originally developed for students in the fields of: Civil Engineering, Environmental Engineering, Applied Earth Sciences and Construction Management and Engineering. These programs are part of the faculty of Civil Engineering and Geosciences at Delft University of Technology in the Netherlands. We try to draw on examples from these fields, but the course contents should be relevant for any engineering or applied geoscience discipline. ``` -You will find this course especially helpful if you have learned programming in another language before or if you would just like to do a refresher course. If you have never taken a programming course and are completely new to programming, it may still be useful, but will also require some extra work. If you find the course difficult, we recommend you consider one of the many free online introduction to computer programming courses that uses the Python language (try searching on EdX or Udacity, for example, but note that we do not require you to pay for a certificate). The course material [Exploratory Computing with Python](https://mbakker7.github.io/exploratory_computing_with_python/) will illustrate pre-requisite topics, but, unlike EdX or Udacity, it is entirely self-study. As an additional study material for learning Python basics, we advise the open source book "Think Python 2nd Edition" by Allen B. Downey. It describes in more detail what is covered in this course. +You will find this course especially helpful if you have learned programming in another language before or if you would just like to do a refresher course. If you have never taken a programming course and are completely new to programming, it may still be useful, but will also require some extra work. If you find the course difficult, we recommend you consider one of the many free online introduction to computer programming courses that uses the Python language (try searching on EdX or Udacity, for example). The course material [Exploratory Computing with Python](https://teachbooks.io/exploratory_computing_with_python/) is an excellent resource that provides a gentler introduction than this one, but, unlike EdX or Udacity, it is entirely self-study. Finally, as an additional study material for learning Python basics, we advise the open source book "Think Python 2nd Edition" by Allen B. Downey. It describes in more detail what is covered in this course. ```{admonition} Note to TU Delft Students (MSc programs) :class: dropdown From 42fe18e076bcef8e0cc9dc78e8b4fa12a349a0dd Mon Sep 17 00:00:00 2001 From: Robert Lanzafame Date: Sat, 11 Jan 2025 04:55:17 +0100 Subject: [PATCH 5/8] update feedback instructions --- book/intro_text.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/book/intro_text.md b/book/intro_text.md index af48ccd..d9c78e3 100644 --- a/book/intro_text.md +++ b/book/intro_text.md @@ -35,4 +35,10 @@ It's really quite simple: read through the 3 Chapters in the Introduction part, ## Feedback and Corrections -We appreciate help to identify mistakes in our course. Links will soon be posted here to help us fix them, as well as a short survey to see if you liked the course! +We are always interested in improving this online book and appreciate help to identify mistakes, as well as general suggestions. The best way to do this is by using the buttons at the top right of each page which link directly to the GitHub repository where this website is hosted. In particular: +- the "Suggest Edit" option allows you to make a correction or suggestion directly (as a Git "commit") +- the "Issue" option allows you to report a general problem or suggest a new feature + +Note that you will need a GitHub account to do this. Once your edit or Issue is submitted, we will incorporate any changes into the book using a Pull Request, and you will be notified via GitHub when this is done. + +If this doesn't work for you, feel free to simply send an email to R.C.Lanzafame@tudelft.nl. \ No newline at end of file From b5fffc6e876b9033c075ce585b4a5612f50ae10f Mon Sep 17 00:00:00 2001 From: Robert Lanzafame Date: Sat, 11 Jan 2025 05:10:01 +0100 Subject: [PATCH 6/8] toolbox-calculator update --- book/03/Exercises/01.ipynb | 2 +- book/Python_Toolbox.md | 22 +++++++++------------- docs/development.md | 2 +- 3 files changed, 11 insertions(+), 15 deletions(-) diff --git a/book/03/Exercises/01.ipynb b/book/03/Exercises/01.ipynb index b77724f..6ce377d 100644 --- a/book/03/Exercises/01.ipynb +++ b/book/03/Exercises/01.ipynb @@ -56,7 +56,7 @@ ":class: tip, dropdown\n", "Click this link and wait until the message \"You may begin!\" is printed to start evaluating code. More information about this tool can be found [here](calculator). \n", "\n", - "Remember that all pages in this course can also be opened as an interactive notebook via Binder or Colab using the {fa}rocket icon above (read more about it [here](nb-links)).\n", + "Remember that most pages in this course can also be run interactively using the {fa}rocket icon above (read more about it [here](toolbox)).\n", "`````" ] }, diff --git a/book/Python_Toolbox.md b/book/Python_Toolbox.md index 7e88b14..1154aeb 100644 --- a/book/Python_Toolbox.md +++ b/book/Python_Toolbox.md @@ -1,6 +1,13 @@ +(toolbox)= # Python Toolbox -This page describes how you will interact with Python in this course, specifically via IPython and Jupyter Notebooks. **IPython** is an interactive Python interpreter that adds feautures that are useful for engineering, such as command history or inline display of figures. As you will see below, you can enter multiple lines of text and evaluate them at once; this is often referred to as a *cell* of code. In a nutshell, if you string many of these cells together into a single digital document, you more or less end up with a **Jupyter Notebook**; this leverages the power of IPython by allowing you to type, run and save the cells in any order, as well as type formatted text in between. Together, these two tools make up our toolbox for this course, and, as you will see, both of them can run in your internet browser, so there is no need to install special software! +This page describes several ways to write and execute Python code, some of which don't require any installation on your computer and work entirely in a web browser! These approaches are described in the sections below, and are based on the tools IPython and Jupyter Notebooks. + +**IPython** is an interactive Python interpreter that adds features that are useful for engineering, such as command history or inline display of figures. As you will see below, you can enter multiple lines of text and evaluate them at once; this is often referred to as a *cell* of code. In a nutshell, if you string many of these cells together into a single digital document, you more or less end up with a **Jupyter Notebook**; this leverages the power of IPython by allowing you to type, run and save the cells in any order, as well as type formatted text in between. Together, these two tools make up our toolbox for this course, and, as you will see, both of them can run in your internet browser, so there is no need to install special software! + +## Interactive Pages + +This course is powered by a special software (the [Sphinx-Thebe](https://github.com/executablebooks/sphinx-thebe) that allows you to run Python code in your browser and gives you an experience that is more or less identical the the "standard" Jupyter Notebook experience you would have on your own computer if you installed the dedicated software. You can access this tool by clicking on the rocket icon ({fa}`rocket`) at the top right of a page where this is enabled. (calculator)= ## IPython: Your Primary Python Calculator @@ -20,7 +27,7 @@ The simple exercise above should be all you need to get started with this course :class: tip, dropdown Click this link and wait until the message "You may begin!" is printed to start evaluating code. More information about this tool can be found [here](calculator). -Remember that all pages in this course can also be opened as an interactive notebook via Binder or Colab using the {fa}rocket icon above (read more about it [here](nb-links)). +Remember that most pages in this course can also be run interactively using the {fa}rocket icon above (read more about it [here](toolbox)). ````` All exercises in this course can be completed using only the Python Calculator. We hope you find it to be a simple but useful way to practice and learn the Python programming language. @@ -29,17 +36,6 @@ All exercises in this course can be completed using only the Python Calculator. A special instance of the Python Calculator is set up for each page which pre-loads a few packages needed to complete the exercise. Make sure you use link that is on the page of the exercises you are working on. ``` -(nb-links)= -## Interactive Jupyter Notebooks - -Although the Python Calculator is all that is needed, it is nice to be able to explore Python by using a Jupyter Notebook. There are two ways these notebooks have been set up to avoid the need for special software, namely: Binder and Colab. These notebooks allow you to run your script in cells, where each cell is equivalent to those in the IPython interpreter. Running cell blocks is more convenient for data analysis since sometimes you just need to change a small part of your code or add some explanation, math formulas, or figures. Therefore, re-running only the corresponding cell is much more efficient. - -No example is provided here, but you can access this tool elsewhere in this course using the links under the rocket icon ({fa}`rocket`) at the top right of the page. Although Colab is the fastest and most reliable service, it is provided by Google, and the data privacy policy is not always clear. As such, Binder is provided as an alternative, but note that sometimes it takes a while for the notebook to load. Both of these options do not allow you to save your work in the notebook (unless you download a file or link a Google account), so be careful when closing a tab! - -```{note} -Due to the way this website is generated from Jupyter Notebooks, when you view the files in Binder or Colab, you will notice oddly formatted text cells: this is the code to generate features like this note on the website, which do not render properly in the notebook environment. You can simply ignore them. In addition, whereas the Python Calculator windows will load properly, there are special pieces of code that need to be run in the notebooks to get them to work properly. Simply follow the instructions in the commented code cell near the top of the notebook, which involves uncommenting one or two lines and executing the cell. -``` - ## Anaconda: Python on Your Computer If you want to explore Python programming and Jupyter ecosystems beyond the exercises covered in this course, it might be worthwhile to install a Python distribution on your own computer. The most common and easiest way to do this is with [Anaconda](https://www.anaconda.com/download). Installation instructions are not included in this course, but you can find plenty of website of videos that cover this, as well as using the Anaconda Navigator to open a Jupyter Lab or Jupyter Notebook environment. Most of the pages in this online textbook can be downloaded in the form of a Jupyter Notebook file (a file ending with `.ipynb`): open it via one of the Jupyter environments and you are ready to go! \ No newline at end of file diff --git a/docs/development.md b/docs/development.md index 58a4995..bf35567 100644 --- a/docs/development.md +++ b/docs/development.md @@ -35,7 +35,7 @@ The example below chooses the kernel, imports pandas and the answer-checker and :class: tip, dropdown Click this link and wait until the message "You may begin!" is printed to start evaluating code. More information about this tool can be found [here](calculator). -Remember that all pages in this course can also be opened as an interactive notebook via Binder or Colab using the {fa}rocket icon above (read more about it [here](nb-links)). +Remember that most pages in this course can also be run interactively using the {fa}rocket icon above (read more about it [here](toolbox)). ``` ```` From 021efd71c7d7227ee346a895f57e5048a83d8754 Mon Sep 17 00:00:00 2001 From: Robert Lanzafame Date: Sat, 11 Jan 2025 05:13:44 +0100 Subject: [PATCH 7/8] fix intro --- book/_toc.yml | 4 ++-- book/intro.md | 2 +- book/{Intro_in_ToC.md => intro_not_in_toc.md} | 2 +- book/intro_text.md | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) rename book/{Intro_in_ToC.md => intro_not_in_toc.md} (98%) diff --git a/book/_toc.yml b/book/_toc.yml index 0f60a71..d64c350 100644 --- a/book/_toc.yml +++ b/book/_toc.yml @@ -2,11 +2,11 @@ # Learn more at https://jupyterbook.org/customize/toc.html format: jb-book -root: intro +root: intro_not_in_toc.md parts: - caption: Introduction chapters: - - file: intro_in_toc.md + - file: intro.md title: Course Overview - file: Python_intro.md title: Programming and Python diff --git a/book/intro.md b/book/intro.md index 431313b..9f5842d 100644 --- a/book/intro.md +++ b/book/intro.md @@ -3,4 +3,4 @@ % The content of this page is defined in a separate file in order to have it appear in the home page of the book (not listed in ToC), as well as to have it listed directly in the ToC in the Introduction Part ```{include} ./intro_text.md -``` +``` \ No newline at end of file diff --git a/book/Intro_in_ToC.md b/book/intro_not_in_toc.md similarity index 98% rename from book/Intro_in_ToC.md rename to book/intro_not_in_toc.md index 9f5842d..431313b 100644 --- a/book/Intro_in_ToC.md +++ b/book/intro_not_in_toc.md @@ -3,4 +3,4 @@ % The content of this page is defined in a separate file in order to have it appear in the home page of the book (not listed in ToC), as well as to have it listed directly in the ToC in the Introduction Part ```{include} ./intro_text.md -``` \ No newline at end of file +``` diff --git a/book/intro_text.md b/book/intro_text.md index d9c78e3..32622f4 100644 --- a/book/intro_text.md +++ b/book/intro_text.md @@ -1,4 +1,4 @@ -% The content of this page is included in two places: the home page of the book intro.md (not listed in ToC), as well as in the Introduction Part of the book Intro_in_ToC.md (listed in ToC) +% The content of this page is included in two places: the home page of the book intro_not_in_toc.md (not listed in ToC), as well as in the Introduction Part of the book into.md (listed in ToC) Welcome to **Python for Engineers**. We're excited to have you join us in this self-paced online course, which is designed to improve your Python skills as well as your understanding of computer programming---especially for applications in engineering and the applied geosciences. Believe it or not, as long as you are using a modern internet browser, you can take complete this course without installing a single piece of extra software! From af208e6f4a341b6cc9fb23d43d0e0b106e2babc1 Mon Sep 17 00:00:00 2001 From: Robert Lanzafame Date: Sat, 11 Jan 2025 05:16:45 +0100 Subject: [PATCH 8/8] better name --- book/_toc.yml | 2 +- book/intro_text.md | 2 +- book/{intro_not_in_toc.md => introduction.md} | 0 3 files changed, 2 insertions(+), 2 deletions(-) rename book/{intro_not_in_toc.md => introduction.md} (100%) diff --git a/book/_toc.yml b/book/_toc.yml index d64c350..bc82162 100644 --- a/book/_toc.yml +++ b/book/_toc.yml @@ -2,7 +2,7 @@ # Learn more at https://jupyterbook.org/customize/toc.html format: jb-book -root: intro_not_in_toc.md +root: introduction.md parts: - caption: Introduction chapters: diff --git a/book/intro_text.md b/book/intro_text.md index 32622f4..9807fb5 100644 --- a/book/intro_text.md +++ b/book/intro_text.md @@ -1,4 +1,4 @@ -% The content of this page is included in two places: the home page of the book intro_not_in_toc.md (not listed in ToC), as well as in the Introduction Part of the book into.md (listed in ToC) +% The content of this page is included in two places: the home page of the book introduction.md (not listed in ToC), as well as in the Introduction Part of the book into.md (listed in ToC) Welcome to **Python for Engineers**. We're excited to have you join us in this self-paced online course, which is designed to improve your Python skills as well as your understanding of computer programming---especially for applications in engineering and the applied geosciences. Believe it or not, as long as you are using a modern internet browser, you can take complete this course without installing a single piece of extra software! diff --git a/book/intro_not_in_toc.md b/book/introduction.md similarity index 100% rename from book/intro_not_in_toc.md rename to book/introduction.md