← Help

Writing course content

Coaches can write and improve the courses for the events they coach. Fix a word on a page, write a whole new course with your AI assistant, or build tests for your group. What you publish goes live for students right away, and every version is kept, so nothing is ever lost.

Who can write, and which courses

You can write the course for every event the admin assigned you. The admin can also make someone an author of a course they don’t coach. If you see Write a course in your account menu, you’re an author of at least one course.

The account menu for Casey Coach, with Write a course at the top, then Change name, Connect Google, Dark theme, Help and Sign out. (opens full size)
Your account menu, at the top right of every page.

This works for every course built with the site’s course engine: most events, and any new course. Five courses are built by hand and can’t be edited this way: Disease Detectives, Rocks and Minerals, Write It Do It, Thermodynamics and Boomilever. To suggest a change to one of those, use Help.

Who sees your changes? Students see what you publish right away, once the course is open to them (In development or Live). While a course is a Draft, only its authors and the admins see it.

Your team’s own copy. A coach’s changes go into your team’s own copy of the course. Only your team’s students see it, and other teams keep the shared course. When the shared course gets better, the coach dashboard shows how many updates there are, and Course updates lets you take the ones you want.

Edit a page in place

The quickest way to fix something. You change the words right where students read them.

  1. Open the page and choose Edit page

    Open any lesson page of your course. Authors see You can edit this course and an Edit page button above the title.

A lesson page, How a Thunderstorm Forms, with You can edit this course and an Edit page button above the title. (opens full size)
  1. Click a box and type

    Everything you can change has a dashed outline: the title, text, notes, steps, and a picture’s caption and description. Click into one and type, just like a document.

  2. Format with the toolbar

    Select some words and use the toolbar: bold, italic, superscript (m2), subscript (H2O), bulleted and numbered lists, and links. Ctrl+B and Ctrl+I work too (⌘B and ⌘I on a Mac). Text you paste from Google Docs or Word keeps its bold and italic and drops the rest.

Edit mode: a dark bar at the top says Editing, 1 change, saved on this device, with Preview, Discard and Publish. The words near the ground are selected and the formatting toolbar shows Bold turned on. (opens full size)
The bar at the top counts your changes. They’re saved on this device as you type.
  1. Fix a question

    Multiple choice, pick-all and true or false questions have an Edit question button. Change the question, the choices, which one is right, or the explanation. The change shows everywhere the question is used, including drills.

The Edit question dialog: the question, four choices with the right one picked, and the explanation, with Cancel and Save question. (opens full size)
  1. Preview, then Publish

    Preview shows the page exactly as students will see it. You can edit several pages before you publish: your changes wait on this device until you’re ready. Publish shows every change word by word, runs the course check, and asks you to confirm you checked your facts. Add a short note about what you changed, and it goes live.

The Publish your changes dialog: the changes word by word, Course check passed, a ticked box saying every fact was checked against a source, and the note Bolded the key phrase and added a line about storm length. (opens full size)
Words taken out are crossed out in red; words put in are green. Two asterisks around words mean bold.

Some parts change only in an upload: worked examples, flip cards, calculators, charts, the sort, label and hotspot activities, other kinds of questions, and adding, removing or moving pages and steps. They show a lock and the words “Change it in an upload”. See Write or rewrite the whole course.

If someone else publishes while you edit, your Publish is stopped so you don’t overwrite their work. Reload the page: your changes to pages they didn’t touch are kept, and the page tells you about any it couldn’t keep.

Write or rewrite the whole course

For bigger work, like new units, pages, pictures, activities or drills, your AI assistant writes the course file and you publish it from the upload page. Choose Write a course in your account menu to open it.

  1. Download the kit

    The kit has everything your assistant needs: the course format and style rules, a sample course, the event’s topics and rules, and the live course so it changes what’s there instead of starting over. Add it to Claude as a skill, or attach its files to a chat, and ask for course.json.

Step 1 of the upload page, Get the kit, with a Download the kit button and a More about the kit link. (opens full size)
  1. Upload your course

    Drop in the .zip your assistant made, or the course.json it wrote and any pictures it names, all in one box. The page checks it at once and lists anything to fix. Copy the list for your AI assistant makes fixing easy: paste the list back to your assistant.

Step 2 of the upload page, Upload your course: one drop box with Choose files; course.json and a picture are added, and the report says No problems found, 2 units, 5 pages, 18 questions, 3 drills. (opens full size)
  1. Preview and publish

    Preview opens your file in a new tab as students will see it, without saving anything. If you gave your assistant past tournament tests, upload them so they join the archive the site uses to write its courses (students never see it), or tick I didn’t use past tests. Say what you changed, then choose Publish.

Step 3 of the upload page, Preview and publish, with the past tests upload, the What did you change box filled in, and the Preview and Publish buttons. (opens full size)
  1. Have another AI check it (optional)

    For a second opinion on the facts, give a different AI assistant these files from the kit: <event>-course.json (the whole live course, once it’s published), <event>-rules.md and SKILL.md. Add the past tests zip if you want it to check that the course matches what tournaments ask and copies nothing. Then paste this:

    Fact-check this course. Use the five passes in SKILL.md’s “Fact-checking” section: check every fact against a reliable source, flag claims that are too strong, recompute every number, answer key and calculator test, check that drawings, charts and activities match the text, and make sure each fact says the same thing everywhere it appears. Also check event facts against the rules file. For each problem, give where it is (page title or question id), what’s wrong, the fix and your source. Don’t rewrite the course.

    Fix what it finds with Edit page, or have your own assistant change course.json and publish it again. Photos from other sites are only addresses in the file, so ask the reviewer to open those links too.

The first time you publish, you’re asked to agree to the contributor note: we can use what you write, it’s yours to share, it isn’t copied, it’s safe for students, and admins can see and change it.

The history, and going back

Every version of the course is kept: who published it, how (an upload, an edit on the page, or going back), their note, and what changed. Find it under History at the bottom of the upload page.

The History list: version 3, live now, uploaded by Casey Coach; version 2, edited on the course page, with its changes shown word by word; version 1, the first version. Versions 1 and 2 have Go back to this version. (opens full size)
Choose What changed to see a version’s changes word by word, or Open to see the whole course as it was.

Made a mistake? Choose Go back to this version on the version you want. The course goes back to it right away. It’s added to the history as a new version, so nothing is lost: you can come back to the newer one the same way.

The Go back to version 1 dialog, which says students see it right away and nothing is lost, with Cancel and Go back to version 1. (opens full size)

Admins see every change too. They can read the history on the admin page and mark what they’ve looked at, so there’s no need to ask before you publish.

Tests for your group

On your coach dashboard, open the Tests tab to build practice tests and assessments for your group. A new test starts with a tournament-style mix of the course’s questions. Swap, edit, reorder or remove any of them, or write your own. Tests belong to your group: they don’t change the course.

A new test: the title Thunderstorm practice, Practice picked, 15 minutes, and 10 questions from the course, easy to hard. (opens full size)

See Building practice tests and assessments for every step: giving a test to your group, results, printing and Google Forms.

Ground rules

  • Check every fact. Use a trusted source, like NOAA, the CDC, USGS or a textbook, and make sure that source is on the course’s source list.
  • Write it yourself. Never copy questions, cases or pictures from past tournament tests, the rules manual, textbooks or other sites. Past tests are for ideas only. Keep them to yourself.
  • Keep it about the event. Teach the topics in the rules, in plain words for middle schoolers.
  • Keep students safe. No student’s name, photo or other personal information.
  • Say what you changed. A short note in the history helps the next author and the admins.

Questions

Can I break the course?

Not for long. The course check stops anything that won’t work, like a missing answer or a broken picture, before it’s published. If something still isn’t right, go back to an earlier version in one step.

Do my changes get lost if I close the tab?

No. Changes made on a page are saved on that device as you type, and wait there until you publish or discard them. They’re on that device only, so finish on the same computer or tablet.

Will students lose their progress when I change a page?

No. Progress is kept by each page and question, so edits keep it. Only removing a page or question in an upload drops the progress on it.

Why don’t I see Edit page?

You see it only on the courses you’re an author of, and only on lesson pages. If you think you should be an author, ask the admin to check your events.

Can I add a new page or picture on the page itself?

Not yet. New pages, pictures, charts and activities come in through the upload page, written with the kit.

Still stuck? See Help to write to us, or Getting started for the rest of what coaches can do.