Skip to content

Commit a638768

Browse files
committed
refactor: weeks are more descriptive now
Signed-off-by: Akshay Mestry <[email protected]>
1 parent 07533fe commit a638768

File tree

2 files changed

+22
-20
lines changed

2 files changed

+22
-20
lines changed
Binary file not shown.

docs/source/course-codex/intro-to-programming.rst

Lines changed: 22 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
.. Author: Akshay Mestry <[email protected]>
22
.. Created on: Saturday, March 08 2025
3-
.. Last updated on: Saturday, March 08 2025
3+
.. Last updated on: Sunday, March 09 2025
44
55
:og:title: Introduction to Programming
66
:og:description: A comprehensive guide to my "ideal" courses to equip students
@@ -75,7 +75,7 @@ By the end of this course, you will:
7575
- solve problems by applying programming to small, personal tasks like
7676
automating a daily chore, parsing a text file, or building a basic to-do app.
7777
- prepare yourself for future courses and industry workloads by building a
78-
strong foundation that will make advanced topics like algorithms, data
78+
strong foundation that will make advanced topics like `algorithms`_, data
7979
structures, AI, and cloud computing far less intimidating.
8080
- learn to Google your way through any debugging session!!!
8181

@@ -89,11 +89,10 @@ Structure
8989
Below is the week-by-week breakdown of how we will proceed through our
9090
curriculum:
9191

92-
Week 01
93-
===============================================================================
92+
.. _developing-a-programming-mindset:
9493

95-
.. rubric:: Programming Mindset or Thinking in Code
96-
:heading-level: 3
94+
Developing a Programming Mindset
95+
===============================================================================
9796

9897
Since it's the first week, we won't dive headfirst into coding but rather
9998
cheekily rewire ourselves to think like a programmer. Before writing fancy
@@ -110,7 +109,7 @@ This week is all about developing a programming mentality.
110109

111110
- Understanding programming as a problem-solving tool.
112111
- How computers **"think"**? Basics of how code gets executed
113-
(interpreted vs. compiled languages).
112+
(`interpreted vs. compiled languages`_).
114113
- Why programming is more about logic than language?
115114

116115
#. **Thinking like a machine**
@@ -120,7 +119,7 @@ This week is all about developing a programming mentality.
120119

121120
#. **Your first program**
122121

123-
- Writing a hello world program in multiple languages (primarily Python).
122+
- Writing a `hello world`_ program in multiple languages (primarily Python).
124123
- Understanding similarities and differences in semantics and syntaxes
125124
across multiple languages.
126125
- Interpreting error messages and searching for solutions on the
@@ -148,11 +147,10 @@ This week is all about developing a programming mentality.
148147
least one example to share next week (it can be anything from a simple
149148
algorithm or someone's personal project you found online).
150149

151-
Week 02
152-
===============================================================================
150+
.. _data-types-the-art-of-naming:
153151

154-
.. rubric:: Variables, Data Types, and The Art of Naming
155-
:heading-level: 3
152+
Data Types & The Art of Naming
153+
===============================================================================
156154

157155
This week, we'll dive deeper into one of the most essential concepts in
158156
programming |dash| variables |dash| and uncover the art and science behind how
@@ -235,11 +233,10 @@ meaningful code.
235233
importance of meaningful variable names. The memes should be different from
236234
what we've seen during the class.
237235

238-
Week 03
239-
===============================================================================
236+
.. _mastering-control-flows-loops:
240237

241-
.. rubric:: Mastering Control Flows and Loops
242-
:heading-level: 3
238+
Mastering Control Flows & Loops
239+
===============================================================================
243240

244241
Last week, we explored variables and data types, building a foundation for how
245242
we store and manage data. Now, it's time to breathe life into our programs by
@@ -320,11 +317,10 @@ meaningful conditional logic that mirrors real-world thought processes.
320317
- Introduce a loop so that the user can keep adding expenses without
321318
restarting the program.
322319

323-
Week 04
324-
===============================================================================
320+
.. _dont-repeat-yourself-with-functions:
325321

326-
.. rubric:: Crafting reusable and purposeful code using Functions
327-
:heading-level: 3
322+
Don't Repeat Yourself with Functions
323+
===============================================================================
328324

329325
By now, we've laid some serious groundwork. We've explored how data is stored
330326
(Week 2) and how programs make decisions and repeat tasks (Week 3). But what
@@ -347,6 +343,9 @@ By the end of this week, we'll not only be able to write basic functions but
347343
also grasp parameters, return values, and scope |dash| the hidden rules that
348344
control what variables live where in your program.
349345

346+
.. image:: ../assets/functions-functions-functions-meme.webp
347+
:alt: Buzz lightyear and Woody meme
348+
350349
.. rubric:: What we'll cover
351350
:heading-level: 3
352351

@@ -412,4 +411,7 @@ control what variables live where in your program.
412411
.. _Java: https://www.java.com/en/download/help/whatis_java.html
413412
.. _Javascript: https://developer.mozilla.org/en-US/docs/Web/JavaScript
414413
.. _Rust: https://www.rust-lang.org
414+
.. _algorithms: https://www.geeksforgeeks.org/fundamentals-of-algorithms/
415+
.. _interpreted vs. compiled languages: https://stackoverflow.com/a/69371092
416+
.. _hello world: https://en.wikipedia.org/wiki/%22Hello,_World!%22_program
415417
.. _GitHub: https://www.github.com

0 commit comments

Comments
 (0)