brief notes on intro pages

rlanzafame · web-flow · commit c2bdf6963e18 · 2025-08-04T05:35:35.000-07:00
diff --git a/book/basics/intro.md b/book/basics/intro.md
@@ -1,6 +1,6 @@
 # Basics
 
-This chapter is all about getting some of the basics under your belt!
+This chapter is all about getting some of the basics of Python under your belt! Even if you have never programmed before, the concepts in this chapter should be easy to understand.
 
 % a short overview for this chapter
 
diff --git a/book/beyond/intro.md b/book/beyond/intro.md
@@ -1,6 +1,6 @@
 # Beyond the Basics
 
-This chapter extends some of the topics we have covered in previous chapters, for example: strings, functions, while adding a new topic about working with files.
+This chapter extends some of the topics we have covered in previous chapters (e.g., strings and functions), while adding a new topic about working with files.
 
 % a short overview for this chapter
 
diff --git a/book/flow/intro.md b/book/flow/intro.md
@@ -1,6 +1,6 @@
 # Flow
 
-This chapter is all about ...
+This chapter takes the building blocks from the previous one and intruces new concepts that of conditional statements and loops that allow you to put them together into short pieces of code; very useful for accomplishing repetetive tasks. Data structures are introduced as well, allowing you to collect and process information in a consistent way.
 
 % a short overview for this chapter
 
diff --git a/book/modules/intro.md b/book/modules/intro.md
@@ -1,6 +1,8 @@
 # Modules
 
-This chapter ...
+This chapter introduces modules, which are critical for understanding how commonly-used third-party libraries like Numpy or Pandas relate to the Python programming language.
+
+Future additions to this chapter may include pages that explain how to create and design modules of your own. If you are interested in seeing more, contact the authors or create an Issue in the GitHub repository!
 
 % a short overview for this chapter
 
diff --git a/book/objects/intro.md b/book/objects/intro.md
@@ -1,6 +1,6 @@
 # Objects and References
 
-This chapter ...
+By now you should be comfortable assigning variables and have used the `=` operator many times. Unfortunately, we need to give you some bad news: that innocent `=` sign is not so simple as you may be used to in a mathematics course! In Python, the `=` operator has some very specific behavior. While this chapter may seem unecessarily complex at the moment, a basic understanding of objects and references can help you a lot later on. We've seen _many_ of our students and colleagues banging their heads against the wall trying to fix a "bug" in their code, only to realize it was a problem with the way they assigned and used variables. 
 
 % a short overview for this chapter
 
