Skip to content

Teaching FAQ

Daniel Budd edited this page Apr 11, 2026 · 1 revision

Teaching FAQ

Questions teachers actually ask about Geometry Playground, answered as directly as possible. Organised by topic.

If your question isn't here, check Troubleshooting for technical issues or Classroom Management for day-to-day operations.

Before adopting

Do I need to know Swift to teach this?

No. You need to know secondary school geometry. Swift is a vehicle for the geometry, and the curriculum is designed so a maths teacher can read the code and understand what it does even if they've never coded.

If you want a 30-minute head start, do Chapters I and II yourself on an iPad before the first lesson. By the end of Chapter II you'll have seen 90% of the Swift syntax the students will meet across all six chapters.

I'm a computing teacher, not a maths teacher. Is this still useful?

Yes, with caveats. The curriculum is a geometry curriculum first and a coding curriculum second. You'll teach the coding content comfortably, but you may feel shaky on some of the geometric theorems (parallel line angle properties in Chapter II, the Pythagorean converse in Chapter IV, similarity and scale factor in Chapter V). Read the relevant sections of a Year 9 or Year 10 maths textbook alongside the curriculum and you'll be fine.

Can I use this without Swift Playgrounds?

Yes, by porting to Python turtle. See the "If you aren't in an Apple environment" section of Classroom Management. The ideas travel cleanly; only the syntax changes.

Is this aligned to my curriculum?

Probably. See Curriculum Alignment NSW for the NSW Stage 5 mapping and Curriculum Alignment International for Common Core, Cambridge, and Australian Curriculum v9 notes. If your jurisdiction isn't covered, the content maps to any Year 9 to Year 10 geometry course with minor adjustments.

How much does it cost?

Nothing. The curriculum, the Swift Playgrounds book, the companion website, and the course-ui library are all free. You need iPads (or Macs) that can run Swift Playgrounds, which is the only real cost.

How long does the whole curriculum take?

Roughly one term to one semester for a typical Year 9 class, depending on pacing. See Scope and Sequence for three suggested plans.

Curriculum and content

Can I skip chapters?

The chapters are designed to build on each other, but you have some flexibility.

  • Chapter I is non-negotiable. It establishes the walking metaphor and the basic drawing primitives. Skip it and nothing else makes sense.
  • Chapters II and III can be taught in either order. Variables before loops is slightly more natural, but you can swap them without damage.
  • Chapter IV can be skipped if you're short on time and don't mind losing conditionals. Chapters V and VI don't strictly depend on it.
  • Chapter V is essential for Chapter VI. Functions are the foundation for composite figures.
  • Chapter VI is the capstone. Skipping it is possible but wasteful; it's the chapter that pulls everything together.

Can I skip sections within a chapter?

Within most chapters, yes. The tutorials (usually sections 1 and sometimes 3) are required, but the drills can be pruned. See each Chapter I teaching notes page for per-chapter advice on what's essential and what's optional.

What's the hardest chapter?

By a wide margin, Chapter II (Shape Properties with Variables). It's the longest (21 sections), densest, and covers the most geometric theorems. Budget three weeks. Don't rush it.

Chapter VI (Composite Figures) is the most cognitively demanding but has fewer sections. Budget two weeks.

What's the easiest chapter?

Chapter III (Polygon Patterns with Loops). Nine sections, one big idea (loops save typing), lots of drill-style exercises where students just swap numbers. It's a good breather after Chapter II.

What ages is this suitable for?

Year 9 (age 13 to 14) is the sweet spot. The geometry matches what they're learning in maths class, and the coding is their first serious programming experience.

Year 8 (age 12 to 13) works for advanced students or dedicated code clubs. The geometry is slightly ahead of their maths class, which is fine and sometimes motivating.

Year 10 (age 14 to 15) works if the students haven't coded before. If they already know Python or Scratch, some of the earlier chapters will feel slow, but Chapters V and VI are still new territory.

Year 7 or younger. Probably too hard. Try Hello World or Everyone Can Code instead.

Year 11 or older. The geometry will be too basic, but the curriculum might still work as a gentle introduction to Swift for students who are scared of "real" programming.

Why Swift and not Python / JavaScript / Scratch?

Three reasons:

  1. Swift Playgrounds is a polished, touch-first editor designed specifically for students on iPad. Nothing else comes close on that form factor.
  2. Swift is a general-purpose language. Students who enjoy Chapters V and VI can build iOS apps or Server-side services with the same language. That's not true of Scratch.
  3. The type system catches errors clearly. Swift's error messages, while not perfect, are better than most languages for beginners.

If you're in a non-Apple school, the "why not Python" answer is "nothing, use Python turtle, it's great". See Classroom Management.

Why the walking metaphor instead of turtle graphics?

Historical baggage. "Turtle graphics" comes from Logo (1967) and is a wonderful idea, but the word "turtle" carries associations with childhood programming that don't serve Year 9 students. "The pen walks" is the same metaphor, described in language that sounds more mature. Students respond better to it.

The underlying mathematics is identical.

Assessment

How do I grade creative coding work?

This is a big topic. See Assessment Strategies for the full answer. The short version: grade on process, decomposition, and code quality, not on "how pretty is the final picture".

Do you provide rubrics?

Yes. See Rubrics for a master rubric and per-chapter criteria.

How do I assess a student who invents something entirely different from the exercise?

Celebrate it. Then assess it against the same rubric: did they decompose the problem? Did they use the constructs from this chapter correctly? Is the code readable? If yes, it's exemplary work even if it doesn't match the original spec. See Assessment Strategies.

How do I know a student copied from a classmate?

Mostly you can't, and mostly it doesn't matter. Copied code doesn't hurt a student who genuinely reads and understands what they copied; that's called "learning from examples" and it's a legitimate engineering practice. The students who are cheating will reveal themselves on the next exercise when they can't explain their own code. Ask them to read it to you.

If you want formal plagiarism checking, have students complete a brief handwritten reflection at the end of each chapter explaining what they learned. You'll know immediately who was paying attention.

What do I put on their report card?

Depends on your school's reporting format. If you need a mark out of 100, use the master rubric in Rubrics and the weighting suggested there. If you need a written comment, focus on the student's growth in decomposition and problem-solving, not on technical Swift skills. The curriculum is a geometry curriculum; that's what you're reporting on.

Classroom logistics

How many iPads do I need?

One per student is ideal. One per pair is workable. Fewer than one per pair is very hard and not recommended.

Do I need iPad Pro models?

No. Any iPad that runs the current version of Swift Playgrounds will work. That includes cheap base-model iPads from the last few years.

What if a student misses lessons?

See the "Managing absences" section of Classroom Management.

What if my students have very different prior coding experience?

Normal and expected. The curriculum is self-paced within a lesson: faster students do more exercises, slower students do fewer. At the end of a chapter, everyone has seen the same material but with different levels of depth. Don't try to force everyone to the same section number at the same time.

Can I do this as homework instead of in class?

Not recommended for the first attempt. The conceptual moments (the variables tutorial, the functions tutorial, the first composite figure) need a teacher present. If you do set homework, set the drill exercises, not the tutorials.

Can students work from home?

Yes if they have a personal iPad or Mac with Swift Playgrounds installed. Their subscription to the Geometry Playground book persists across devices signed in with the same Apple ID, so a student who subscribes at school can continue at home.

Technical and platform

The book isn't updating. Is there a new version?

Swift Playgrounds should update subscribed books automatically. If not, see Troubleshooting.

The companion website looks different on my phone.

The site adapts to phone screens but is designed for tablet and desktop. On a small phone, some elements stack vertically. Everything is still functional.

Can I download the book for offline use?

Yes. Once subscribed, the book is local on the device. Students can work offline. They'll only need internet to receive updates.

Is there a teacher-only version with answer keys?

No. The teaching notes pages on this wiki (Chapter I through Chapter VI) are the closest equivalent. They walk through the intent of each section and flag the common misconceptions, which is more useful than a raw answer key.

If you want to see "an answer" for any exercise, the starter code plus a few minutes of experimentation will get you there. Most exercises have many valid answers.

Can I modify the curriculum for my students?

Yes. The Swift Playgrounds book is subscribed, so you can't modify the book itself, but you can:

  1. Have students add extra pages for variations (see Classroom Management).
  2. Write your own exercises as separate playgrounds and share them via AirDrop or iCloud.
  3. Maintain your own companion worksheets with additional questions referencing the exercises.
  4. Fork the companion website (it's open source on GitHub, see Home) and run your own version.

Can I contribute suggestions or corrections?

Yes, please. Open an issue on the GitHub repository or contact the author via the links on Home. Teacher feedback is the single most valuable input to this project.

Why is this a wiki instead of a polished website?

Because wikis are fast to edit and easy for a single author to maintain. A polished website implies an editorial team. A wiki implies a working document. The curriculum itself is polished (the Swift Playgrounds book and the companion site); the wiki is a place where a teacher can find an answer in under a minute without wading through marketing copy.

Philosophy

Why are there no videos?

Videos age badly (interfaces change, voices sound dated, the author moves on) and they're harder to update than text. Text is also skimmable and searchable, which is what a busy teacher needs.

If you want a video introduction for yourself or your students, the Apple Education website has general Swift Playgrounds videos that cover the interface. The content of Geometry Playground is best learned by doing, not watching.

Why British English and Australian context?

Because that's where the author teaches. If you're in the USA or another English-speaking country, the spelling differences are minimal ("colour", "metre", "programme") and the context differences are almost nonexistent. Flags in Chapter V include the Union Jack and the US flag alongside many others. Nothing is jurisdictionally locked.

Why a walking metaphor instead of coordinates?

See "Why the walking metaphor instead of turtle graphics?" above. Students understand walking because they walk. They don't understand coordinate planes until you teach them, and coordinate planes are the subject of Chapter I, so using coordinates to teach Chapter I would be circular.

Chapter V reintroduces explicit coordinates (for positioning shapes) once students are ready.

Why six chapters?

Because six is the natural length of one school term. Fewer feels shallow; more feels like a commitment. Six chapters lets a teacher adopt the curriculum for "one term" without having to think hard about whether they can finish it.

What's the long-term plan for the project?

Ongoing polish and maintenance. No current plan for Chapter VII, though a sister project on VEX V5 robotics is in early planning. See Changelog for recent changes.

Links

Clone this wiki locally