diff --git a/book/_toc.yml b/book/_toc.yml
index 040dde2556984354bb543bea3552e30e231abb10..81ae3c463a1fbcd9a7df2a7d84653afe2b2ab24e 100644
--- a/book/_toc.yml
+++ b/book/_toc.yml
@@ -171,6 +171,7 @@ parts:
       title: Overview
     - file: programming/golden_rules.ipynb
       title: The Golden Rules
+# START REMOVE-FROM-PUBLISH
     - file: programming/code/overview
       title: Computers & Code
       sections:
@@ -182,6 +183,7 @@ parts:
       title: Communication
       sections:
       - file: programming/communication/visualization
+# END REMOVE-FROM-PUBLISH
 # START REMOVE-FROM-PUBLISH
   - caption: Fundamental Concepts
     numbered: 2
diff --git a/book/intro.md b/book/intro.md
index b111c9a41f2b2ce38250c7657e0832cbecb27959..ae53d2229f4f9c4e2c36933fa040c1906e53c27e 100644
--- a/book/intro.md
+++ b/book/intro.md
@@ -1,5 +1,15 @@
 # Welcome to the MUDE Textbook
 
-Welcome to the MUDE textbook.
+Welcome to the MUDE textbook. This is where assigned reading is located, along with interactive exercises to practice and study the module material.
 
-_this is where stuff will be written later_
+Content in this textbook will be added throughout the semester, and changes will be announced and documented as needed. When new content is added, it will be done in large chunks. Changes will not be made retroactively that impact the scope of the exams (in other words, you will never need to re-study material because it changed prior to the exam). Notifications of errors, corrections and suggestions for improvement are glady welcomed via the Answers platform and/or via the MUDE email address.
+
+
+```{admonition}Interactive Pages: Use Python in your Browser!
+    
+This online textbook has a number of pages that are set up to be used interactively. On such pages you can use the "Live Code" button under the Rocket Ship icon in the top right to activate the interactive features and use Python interactively!
+
+Sometimes the interactivity will involve completing an exercise, wheras on other pages it might simply provide the opportunity to edit the contents of code cells and execute it to explore the page contents interactively. Other pages may provide interactive figures (e.g., widgets).
+
+This is a new feature that we are actively working to incorporate in the MUDE textbook, so please provide us feedback via the [Answers platform](https://answers.citg.tudelft.nl/) if things go well or you have suggestions for improvement.
+```
\ No newline at end of file
diff --git a/book/programming/golden_rules.ipynb b/book/programming/golden_rules.ipynb
index f0b95e52ae0426c19b13ac8dd80eca03560162d3..c252010dd3da5787000a43f21c329e7e679ce11a 100644
--- a/book/programming/golden_rules.ipynb
+++ b/book/programming/golden_rules.ipynb
@@ -34,7 +34,13 @@
     "We focused on illustrating good programming practices in a format and language that is approachable to engineers with a varied programming background. As such, specific fundamental programming and computer science concepts are avoided. If you would like to learn more about theses concepts, specifically related to Python, the textbook by Guttag (2021) is an excellent reference.\n",
     "\n",
     "<div class=\"alert alert-block alert-success\">\n",
-    "<b> Note </b>\n",
+    "<b> Note 1 </b>\n",
+    "    \n",
+    "This notebook is meant to be used interactively. Use the \"Live Code\" button under the Rocket Ship icon in the top right to activate the page and use Python interactively!\n",
+    "</div>\n",
+    "\n",
+    "<div class=\"alert alert-block alert-success\">\n",
+    "<b> Note 2 </b>\n",
     "    \n",
     "Whether you are a student, teacher or practitioner, we encourage you to [refer back to this document](https://mude.citg.tudelft.nl/book/programming/golden_rules.html) often and feel free to download it as a `*.ipynb` file to share. We expect to periodically update this document and perhaps share other topics in the 'Golden Rules' series. \n",
     "\n",
diff --git a/book/programming/overview.md b/book/programming/overview.md
index e44c1f89cf48a6096a4ae942db502a39827098ad..cdbf85f5d3b6939a49c8615047fc2bd5ee496fec 100644
--- a/book/programming/overview.md
+++ b/book/programming/overview.md
@@ -1,6 +1,6 @@
 # Programming Overview
 
-Riccardo ideas. For now, when in doubt add content to the JB. Can move text to website later as needed.
+<!-- Riccardo ideas. For now, when in doubt add content to the JB. Can move text to website later as needed.
 1. theory + best practices with examples for efficient numerical practices
 2. theory + best practices with examples of for loops (and not for loops)
 3. ~~Visualization:~~
@@ -14,12 +14,18 @@ Riccardo ideas. For now, when in doubt add content to the JB. Can move text to w
    3. saving results of analyses---would this be pickle? ideally we should teach them how to create a JSON and binary (pickle) format, then they choose whats best (for example, the JSON is readable and may be useful to share with a colleague who cannot run nb's in combination with a PDF printout of the nb). This is a great example where we should have content in the book that then is referred to as needed when students run into issues in submitting reports (i.e., their nb is 10 MB, now what?)
 6. IDE's: a brief overview, then a recommendation and case study with Jupyter Lab and VS Code
 7. package management: we need some theory on this, but it should be concise. Since Robert is already working with the TA's about environments, maybe it's best to leave this one alone till the end
-8. Some handy tricks (we can make a special page on the website to quickly illustrate things described above, and provide links to the theory, explanation and case studies in the textbook)
+8. Some handy tricks (we can make a special page on the website to quickly illustrate things described above, and provide links to the theory, explanation and case studies in the textbook) -->
 
+In this textbook the programming part is a collection of pages that cover key concepts of programming and computer science without diving too far into the details. As a pre-requeisite, it is assumed you have had a BSc-level introductory course in computer programming. It is not required that it used the Python language. Over the course of the semester, content will be added to this part of the textbook and organized under the five loosely defined Chapters below:
+
+1. This Overview page.
+2. The Golden Rules: key tips and guidelines for good Documentation and Communication; we will refer to these often. THe intention is that they help you form good programming habits that you will continue to use for the rest of your life.
+3. Computers & Code: this may grow to include background information about computers (e.g., how they store data) as well as information specific to the Python language (e.g., environments and package management).
+4. Programs: essentials for scientific computing (e.g., modular programming; object-oriented programming, version control, Debugging and error handling 
+5. Communication (and documentation): visualization, version control, sharing your work
+
+Software is also considered part of the programming learning line, but that will be covered exclusively on the module website, including instructions for installation and typical workflows.
 
-## Why do you need Python? 
-    
-Python is a computer programming language that is widely used in both academia and industries related to Civil Engineering, Environmental Engineering and Applied Earth Sciences. Being skilled in Python will help you on multiple occasions, including in your master courses. 
 
 ## What can computers do for us?
 As an engineer or scientist, you will deal with units of information which are called <b>data</b>. The most important tasks that a computer can do for us are:
@@ -59,8 +65,14 @@ There are five different kinds of instructions for computations you use. By orde
 <b>repetition:</b>
     Perform instructions repeatedly, usually with some variation.
 
+In addition to these traditional definitions of programming, in MUDE we also extend the term to include a larger range of tasks related to computers and computer science; for example, documentation and communication of your results, or sharing your code and analysis with others. This will be described elsewhere in this part of the textbook, but for now, we will focus on the Python programming language.
+
 ## Introduction to Python
+
+**Why do you need Python?**
     
+Python is a computer programming language that is widely used in both academia and industries related to Civil Engineering, Environmental Engineering and Applied Earth Sciences. Being skilled in Python will help you on multiple occasions, including in your master courses. _
+
 The features of Python are what make it so popular. From the definition available on the corresponding Wiki page: <i> "Python is an <b>interpreted</b> <b>high-level</b> <b>general-purpose</b> <b>programming language</b>. Its design philosophy emphasizes code readability with its use of significant indentation. Its language constructs, as well as its object-oriented approach aim to help programmers write clear, logical code for small and large-scale projects."</i>. Quite a simple, yet concise description due to the meaning hidden behind each buzzword:
 
 <ul>
@@ -75,28 +87,10 @@ Python scripts run with the help of a Python interpreter, but they can be writte
 For this course we will use a slightly different approach to developing a Python script: <b>IPython</b> and <b>Jupyter Notebooks</b>. Think of these as two freely-available tools that add extra functionality to the basic Python programming language. As an example, imagine the camera built into your phone: on it's own it can take pictures, but there are many apps that add filters or sharing via social media that make the impact of your photos much more powerful. This is exactly what IPython and Jupyter Notebooks do for Python, and why they are such important tools in the toolbox of modern engineers. The next Chapter will introduce you to your Python Toolbox for this course!
 
 
-Loosely broken down into 4 Chapters, with some ideas for possible contents (will fine tune location as we create it!):
-
-1. Golden Rules (part of Communication, but introduced at beginning to set the stage)
-2. Computers: essentials concepts for Scientific Computation and Numerical Analysis 
-   1. Machine code, compilers, low- and high-level languages; Bits and bytes, storage, memory, precision; File types (e.g., txt, csv, ipynb, py, md; text and binary); 
-Data types (e.g., csv, JSON, netcdf, etc); FLOPS, run time; Complexity  
-3. Code: Instructions. Executed. 
-   1. Programming language (Python), Environments and package management, Fundamentals of programming, Executing code, Other languages 
-4. Programs: essentials for scientific computing 
-   1. Modular programming; Object-oriented programming, Version control, Debugging and error handling 
-5. Communication (and documentation)
-   1. Golden Rules, Visualization, Version control, Sharing your work (Static (*.ipynb, *.pdf, *.html) and Dynamic/Interactive (something with a Python kernel), Open-Source Projects / Collaboration 
-   2. some of this may be moved to the website; most will be short, except git
-
-
-Software is also considered a programming category, but that will be covered exclusively on the website.
-
-**We will use this as the baseline "theory" this year with extra insight provided for use, and other topics as-needed. Links here for easy copy/paste.**
-
-Part of the programming material for MUDE goes well beyond the scope of a typical BSc-level programming course (a MUDE pre-requisite), and part relies on the online course "Python for Engineers." Regardless of your background in Python, or programming in general, you can always benefit from learning and reviewing a few fundamentals of computer science.
+## Online Course: Python for Engineers
+<!-- *We will use this as the baseline "theory" this year with extra insight provided for use, and other topics as-needed. Links here for easy copy/paste.* -->
 
-The online course [Python for Engineers](https://tudelft-citg.github.io/learn-python/intro.html) provides a series of exercises as well, which you should use to practice your understanding of the topics. Since you should have Anaconda installed for MUDE, we recommend you download the notebook pages directly, where possible, and use your own Python kernel (e.g., a Jupyter notebook as a workbook) for the chapters that only require simple calculations.
+Part of the programming material for MUDE goes well beyond the scope of a typical BSc-level programming course (a MUDE pre-requisite), and part relies on the online course "Python for Engineers." Regardless of your background in Python, or programming in general, you can always benefit from learning and reviewing a few fundamentals of computer science. The online course [Python for Engineers](https://tudelft-citg.github.io/learn-python/intro.html) provides a series of exercises as well, which you should use to practice your understanding of the topics. Since you should have Anaconda installed for MUDE, we recommend you download the notebook pages directly, where possible, and use your own Python kernel (e.g., a Jupyter notebook as a workbook) for the chapters that only require simple calculations. Links to each chapter are provided here for easy reference.
 
 Chapters from online course "Python for Engineers":
 1. [Variables, operators and functions](https://tudelft-citg.github.io/learn-python/01/Theory/01.html#)