removed the old CoderDojo TC name and the new name is now "Beginning Python"

Author: dmccreary

CONTENT-GENERATION-GUIDELINES.md

@@ -0,0 +1,195 @@
+# Content Generation Guidelines — Beginning Python
+
+This file defines rules for generating student-facing content in this course.
+All AI agents and human authors creating lessons, labs, quizzes, or other
+student-facing pages must follow these guidelines. Instructor-facing content
+(teacher's guide, course description) does not need to use the mascot.
+
+---
+
+## Learning Mascot: Monty the Python
+
+### Mascot File Index
+
+The canonical files for this mascot. When editing any of these, update the
+others in the same turn so they stay in sync.
+
+| File | Purpose |
+|------|---------|
+| [`docs/img/mascot/neutral.png`](docs/img/mascot/neutral.png) | Default / general-purpose pose |
+| [`docs/img/mascot/welcome.png`](docs/img/mascot/welcome.png) | Chapter-opening pose |
+| [`docs/img/mascot/thinking.png`](docs/img/mascot/thinking.png) | Key-concept pose |
+| [`docs/img/mascot/tip.png`](docs/img/mascot/tip.png) | Hint / helpful-guidance pose |
+| [`docs/img/mascot/warning.png`](docs/img/mascot/warning.png) | Common-mistake / pitfall pose |
+| [`docs/img/mascot/encouraging.png`](docs/img/mascot/encouraging.png) | Difficult-content / struggle pose |
+| [`docs/img/mascot/celebration.png`](docs/img/mascot/celebration.png) | End-of-chapter / achievement pose |
+| [`docs/css/mascot.css`](docs/css/mascot.css) | Custom admonition styles for the seven pose contexts |
+| [`docs/learning-graph/mascot-test.md`](docs/learning-graph/mascot-test.md) | Rendering test page that exercises every admonition style |
+
+### Character Overview
+
+- **Name**: Monty
+- **Species**: Python snake
+- **Personality**: Curious, encouraging, patient, playful, never sarcastic or intimidating
+- **Catchphrase**: "Let's code it together!"
+- **Visual**: Friendly cartoon python with bright emerald-green scales, oversized round wire-rim
+  glasses, large sparkling blue-green eyes, two small expressive arms, and a curling tail.
+  Flat vector style, transparent background, consistent across all poses.
+
+### Voice Characteristics
+
+- Uses simple, encouraging language appropriate for ages 10–14
+- Celebrates small wins — never dismisses a question as "easy"
+- Refers to students as "coders" or "programmers"
+- Occasionally uses Python puns ("Let's uncoil this problem!", "I've got a hiss-tory of coding!")
+- Never uses jargon without defining it first
+- Signature phrases: "Let's code it together!", "You've got this!", "Great question!"
+
+### Mascot Admonition Format
+
+**Always** place mascot images in the admonition body, never in the title bar.
+Use the Markdown image syntax with the `mascot-admonition-img` class:
+
+```markdown
+!!! mascot-welcome "Welcome to This Lesson!"
+    ![Monty waving welcome](../../img/mascot/welcome.png){ class="mascot-admonition-img" }
+    Admonition text goes here after the image. Keep it to 1–3 sentences.
+```
+
+**Image path depth:** The path `../../img/mascot/` is correct for pages two
+directories deep (e.g., `skulpt/02-simple-square/` or `trinket/04-loops/`).
+For pages at the root of `docs/`, use `img/mascot/`.
+For pages one level deep (e.g., `docs/strategy/index.md`), use `../img/mascot/`.
+
+### Placement Rules
+
+| Context | Admonition Type | Image | Frequency |
+|---------|----------------|-------|-----------|
+| Lesson opening | `mascot-welcome` | `welcome.png` | Once per lesson — always first |
+| Key concept or insight | `mascot-thinking` | `thinking.png` | 1–2 per lesson |
+| Helpful hint or shortcut | `mascot-tip` | `tip.png` | As needed |
+| Common mistake / pitfall | `mascot-warning` | `warning.png` | As needed |
+| Difficult content | `mascot-encourage` | `encouraging.png` | Where students may struggle |
+| End of lesson / experiments | `mascot-celebration` | `celebration.png` | Once per lesson — always last |
+| General sidebar | `mascot-neutral` | `neutral.png` | As needed |
+
+### Hard Limits
+
+- **Maximum 6 mascot admonitions per lesson** — more than this interrupts reading flow
+- **No back-to-back mascot admonitions** — always separate with at least one paragraph of content
+- **One `mascot-welcome` maximum per lesson** — always at the very start
+- **One `mascot-celebration` maximum per lesson** — always at the very end
+- Do not use mascot admonitions purely for decoration — every use must add instructional value
+
+### Do's and Don'ts
+
+**Do:**
+- Use Monty to introduce new topics warmly at the start of every lesson
+- Include the catchphrase "Let's code it together!" in welcome admonitions
+- Keep dialogue brief (1–3 sentences maximum)
+- Match the pose image to the content type (tip pose for tips, warning pose for warnings)
+- Write in Monty's encouraging, kid-friendly voice
+
+**Don't:**
+- Use Monty more than 6 times in a single lesson
+- Put mascot admonitions back-to-back without intervening content
+- Change Monty's personality or make him sound sarcastic or intimidating
+- Use `<img>` HTML tags — always use Markdown image syntax with `{ class="mascot-admonition-img" }`
+- Place images in the admonition title bar
+
+---
+
+## Skulpt Lab Format
+
+All Skulpt interactive labs share a common structure. When generating a new
+Skulpt lab page, follow this template exactly:
+
+### Page Structure
+
+```markdown
+# Lesson Title
+
+Brief intro paragraph (1–2 sentences about what the lesson covers).
+
+!!! mascot-welcome "Welcome to This Lesson!"
+    ![Monty waving welcome](../../img/mascot/welcome.png){ class="mascot-admonition-img" }
+    1–3 sentences from Monty introducing the lesson in his encouraging voice.
+
+## Sample Code
+
+[fenced code block with Python]
+
+## Try It Now
+
+Edit the code below and click **Run** to see the result right on this page.
+No account needed — everything runs in your browser.
+
+[Skulpt lab HTML block — see below]
+
+## How It Works
+
+Explanation of the key concepts in the code.
+
+[optional mascot-thinking or mascot-tip admonition here]
+
+## Explanation Table
+
+| Line | What it does |
+|------|-------------|
+| ... | ... |
+
+[optional mascot-warning admonition if there are common mistakes]
+
+## Experiments
+
+1–5 numbered experiments for students to try.
+
+!!! mascot-celebration "Great Work!"
+    ![Monty celebrating](../../img/mascot/celebration.png){ class="mascot-admonition-img" }
+    Congratulations! You've completed this lesson. Try the experiments above to go further!
+```
+
+### Skulpt HTML Block
+
+Every Skulpt lab uses this exact HTML block. The CDN scripts load Skulpt;
+`skulpt.js` (via `extra_javascript`) and `skulpt.css` (via `extra_css`)
+provide the shared functions and styles.
+
+```html
+<script src="https://skulpt.org/js/skulpt.min.js"></script>
+<script src="https://skulpt.org/js/skulpt-stdlib.js"></script>
+
+<div id="skulpt-lab">
+  <div id="editor-container">
+    <textarea id="code" spellcheck="false">PYTHON CODE HERE
+</textarea>
+    <div id="button-row">
+      <button id="run-btn" onclick="runSkulpt()">&#9654; Run</button>
+      <button id="reset-btn" onclick="resetSkulpt()">&#8635; Reset</button>
+    </div>
+    <pre id="output"></pre>
+  </div>
+  <div id="canvas-container">
+    <div id="turtle-target"></div>
+  </div>
+</div>
+```
+
+**Rules:**
+- The Python code inside `<textarea>` must match the Sample Code block exactly
+- Do not add inline `<style>` or `<script>` tags — all CSS/JS is centralized
+- The element IDs (`skulpt-lab`, `editor-container`, `code`, `button-row`,
+  `run-btn`, `reset-btn`, `output`, `canvas-container`, `turtle-target`) must
+  not be changed — `skulpt.js` depends on them
+
+---
+
+## General Writing Style
+
+- **Audience**: Kids ages 10–14, just after learning Scratch
+- **Tone**: Friendly, encouraging, never condescending
+- **Sentences**: Short and clear — aim for a 6th-grade reading level
+- **Code comments**: Use `#` comments in Python code to explain non-obvious lines
+- **Experiments section**: Every lesson must end with 3–5 open-ended experiments
+  that invite students to modify the code and explore
+- **No external links to Trinket** in new Skulpt lessons — these labs are self-contained

docs/advanced/mnist.md

@@ -1,6 +1,6 @@
 # Handwritten Digit Classification
 
-We will program and train a machine learning model to recognize handwritten numbers. The code for this lesson can be found [here](https://github.com/CoderDojoTC/python/blob/master/advanced/machineLearning/mnist.ipynb).
+We will program and train a machine learning model to recognize handwritten numbers. The code for this lesson can be found [here](https://github.com/dmccreary/python/blob/master/advanced/machineLearning/mnist.ipynb).
 
 ## But What *Is* Machine Learnig?
 

docs/advanced/stocks.md

@@ -1,4 +1,4 @@
 # Stock Analysis and (Virtual) Trading With Python
 **Disclaimer - This is NOT Financial advice**
 
-Checkout the notebook [here](https://github.com/CoderDojoTC/python/blob/master/advanced/dataAnalysis/stockTrader.ipynb).
+Checkout the notebook [here](https://github.com/dmccreary/python/blob/master/advanced/dataAnalysis/stockTrader.ipynb).

docs/css/mascot.css

@@ -1,12 +1,12 @@
 /* ============================================
    Learning Mascot: Monty the Python
-   Pedagogical agent for CoderDojo TC Python
-   CoderDojo brand: primary #642580, accent #41BAC1
+   Pedagogical agent for Beginning Python
+   Colors: primary #642580 purple, accent #41BAC1 teal
    ============================================ */
 
 :root {
-  --mascot-primary:   #642580;   /* CoderDojo purple   */
-  --mascot-secondary: #41BAC1;   /* CoderDojo teal     */
+  --mascot-primary:   #642580;   /* primary purple   */
+  --mascot-secondary: #41BAC1;   /* accent teal     */
   --mascot-bg:        #f3eaf8;   /* light purple tint  */
   --mascot-border:    #7a2f9e;   /* medium purple      */
   --mascot-size: 90px;
@@ -30,7 +30,7 @@
   font-size: inherit;
 }
 
-/* ---- Welcome (chapter openings) — CoderDojo purple ---- */
+/* ---- Welcome (chapter openings) — primary purple ---- */
 .md-typeset .admonition.mascot-welcome,
 .md-typeset details.mascot-welcome {
   border-color: var(--mascot-primary);
@@ -42,7 +42,7 @@
   color: white;
 }
 
-/* ---- Thinking (key concepts) — CoderDojo teal ---- */
+/* ---- Thinking (key concepts) — accent teal ---- */
 .md-typeset .admonition.mascot-thinking,
 .md-typeset details.mascot-thinking {
   border-color: var(--mascot-secondary);

docs/index.md

@@ -1,4 +1,4 @@
-# CoderDojo Twin Cities Python Resources
+# Beginning Python Resources
 This GitHub repository is for sharing teaching resources to teach Python. This includes hints on getting your Python environments setup up and extensive lesson plans for several environments.
 
 

docs/intermediate/01-intro.md

@@ -1,6 +1,6 @@
 # Introduction to Intermediate Python
 
-This course assumes you are familiar with beginning concepts in Python such as variables, loops, conditionals, random numbers, functions, function parameters, lists and basic recursion.  We strongly suggest that you have completed the [CoderDoj Twin Cities Beginning Python Class](../trinket/00-introduction.md) BEFORE you do the intermediate labs.
+This course assumes you are familiar with beginning concepts in Python such as variables, loops, conditionals, random numbers, functions, function parameters, lists and basic recursion.  We strongly suggest that you have completed the [Beginning Python Class](../trinket/00-introduction.md) BEFORE you do the intermediate labs.
 
 Note that you can do the first four lessons using web-based Python programming tools like Trinket.io or repl.it.  Starting with lesson #5 on Files you will need to have Python installed on your local computer.  Please visit the [Python.org](http://python.org) web site for the installation instructions on your operating systems.  You can use the command-line version of Python from a Terminal or shell or you can install one of the Python Integrated Development Environments (IDEs).
 
@@ -11,7 +11,7 @@ The concepts in this course include:
 3. [**Checking Data Types of Function Parameters**](./03-data-type-validation.md) - in the beginning course we learned how to pass parameters to functions.  Now we learn how to make sure our functions get the data that they expect!
 4. [**Maps**](./04-maps.md) - Maps or dictionaries are sets of key-value pairs that are crazy flexible.  Unlike a list, where the index can only be fixed sequence of integers starting with 0, the keys in a map can be any integer or string in any order.
 5. [**Files**](./05-files.md) - In this lesson we will learn how to open a file and read the data into our program with just a few lines.  Not only can we read in data, but we can also write out data!  So much power in a few lines of code!
-6. [**Images**](./06-images.md) - In our CoderDojo AI Racing League we will be learning how to make a car drive autonomously.  But first we need to be able to read in images and display them.  In this lab we will show you how easy this is!
+6. [**Images**](./06-images.md) - In our AI Racing League we will be learning how to make a car drive autonomously.  But first we need to be able to read in images and display them.  In this lab we will show you how easy this is!
 7. [**Defining Your Own Modules**](./07-modules.md) - In the Beginning Python class we learned how to create functions.  Now we learn how to package them up so they are easy for others to use.
 8. [**dir() function**](./08-dir.md) - If you ever want to know what functions you can throw at something we got this secret tool called "dir".  It really takes the mystery out of what functions you can use and avoids trying to guess what function names are used.  Not that guessing games aren't fun!
 9. [**Regular expressions**](./09-regex.md) - You sometimes want a list of all the files in a folder that have a .jpg extension for images.  This lesson will show you how we can use a shorthand notation to make it easy to specify what files to include and which ones to skip.

docs/intermediate/06-images.md

@@ -8,4 +8,4 @@ my_image = Image.open("/path/to/image.jpg")
 my_image.show()
 ```
 
-The CoderDojo AI Racing League will explore more around working with image data.
+The AI Racing League will explore more around working with image data.

docs/intermediate/bfsMaze.md

@@ -6,7 +6,7 @@ In this lab, we are going to solve a maze with an **algorithm** called **breadth
 
 * A **queue** is another commonly used data structure. Think of it as a line that we always take from the front of and always add to the back (no budging).
 
-First, download the code template found in the ```src/intermediate``` folder of the repository, found [here](https://github.com/CoderDojoTC/python). Then, lets try and implement a solution to solve it!
+First, download the code template found in the ```src/intermediate``` folder of the repository, found [here](https://github.com/dmccreary/python). Then, lets try and implement a solution to solve it!
 
 One solution is breadth-first search, or BFS. BFS works by cycling through all possible nodes one hop away from your current position, adding them to a **queue** and then cycling through all of those nodes in the queue to see if they are the solution. Lets see how it is implemented below:
 

docs/pi/01-intro.md

@@ -2,7 +2,7 @@
 
 - [Raspberry Pi Foundation Projects](https://projects.raspberrypi.org/en)
 
-- [CoderDojo Pages on the Pi Site](https://projects.raspberrypi.org/en/coderdojo)
+- [Raspberry Pi CoderDojo Projects](https://projects.raspberrypi.org/en/coderdojo)
 
 - [Thonny](https://thonny.org/)Thonny is a Integrated Development Environment for debugging Python code.  Unfortunatly, no turtle graphics are supported.
 

mkdocs.yml

@@ -1,6 +1,11 @@
-site_name: 'CoderDojo TC Python'
+site_name: 'Beginning Python'
+site_description: 'Resources for teaching Python to beginning programmers.'
+site_author: 'Dan McCreary'
+repo_name: 'GitHub Repo'
+repo_url: 'https://github.com/dmccreary/python'
+site_url: 'https://dmccreary.github.io/python/'
+
 nav:
-  - CoderDojo TC: https://coderdojotc.github.io/CoderDojoTC/
   - Beginning Python - Trinket:
     - Introduction: trinket/00-introduction.md
     - Setting Up Trinket: trinket/01a-trinket-account.md
@@ -28,6 +33,8 @@ nav:
   - Beginning Python - Skulpt (self-hosted):
     - Draw a Square: skulpt/02-simple-square.md
     - Stop Sign: skulpt/04a-stop-sign.md
+  - Reference:
+    - Mascot Style Guide: learning-graph/mascot-test.md
   - Beginning Python - Repl.it:
     - Square: repl/02-square.md
     - Flower: repl/07-flower.md
@@ -70,16 +77,13 @@ nav:
   - Contact:
     - Contact: contact.md
 
-site_description: 'Resources for teaching Python to CoderDojo Twin Cities students.'
-site_author: 'Dan McCreary'
-repo_name: 'GitHub Repo'
-repo_url: 'https://github.com/CoderDojoTC/python'
 
-# CoderDojo Standards from here down
+
+# Site configuration
 edit_uri: 'blob/master/docs'
 theme:
   name: material
-  logo: img/coderdojo-logo.png
+  logo: img/python-logo.jpeg
   palette:
     primary: '#642580'
     accent: '#41BAC1'
@@ -89,7 +93,10 @@ theme:
   include_sidebar: true
 markdown_extensions:
   - admonition
+  - attr_list
   - footnotes
+  - md_in_html
+  - pymdownx.details
   - pymdownx.highlight
   - pymdownx.superfences
   - toc:
@@ -98,6 +105,7 @@ plugins:
     - search
 extra_css:
   - css/skulpt.css
+  - css/mascot.css
 extra_javascript:
   - js/skulpt.js
 # Google Analytics Site ID: G-EP38Z3PVD5