Publishing and sharing

Checking and publishing

How validation works, which problems can be accepted with Publish anyway, and which can never be overridden.

Problems, warnings and suggestions

Choose Validate in the editor to check your saved draft. The results are grouped:

  • Must fix: something is missing or would mislead learners. These block publishing.
  • Check these: probably a problem, but it may be what you intended. Look at them, then you can publish.
  • Suggestions: optional ideas that usually make a set easier to learn from.

Each result links to the concept and field. The checks catch structural problems and common question-writing mistakes; they can't tell whether your facts are right, so check those yourself.

Problems that always block publishing

Some problems would break the set for learners. They can never be accepted, and the server checks them again whatever the browser sends:

  • a concept without a topic, a question or a correct answer;
  • fewer than 3 or more than 9 wrong answers, two identical wrong answers, or a wrong answer that is the correct answer or an accepted answer;
  • a set with no concepts, or a set or section without a title;
  • pictures that aren't in this set, or picture answer options that don't line up with the wrong answers;
  • malformed diagrams or grading criteria, content that's too large or contains hidden control characters;
  • AI-written concepts that haven't been marked reviewed.

Accept as is and Publish anyway

Other problems are judgment calls, for example a concept with no lesson text, two concepts with the same name, a flashcard with only one side, or a source link that isn't valid (it's left out when you publish).

  • Accept as is, next to a problem in the editor, keeps that one as it is. Undo reverses it.
  • Publish anyway, in the publish dialog, accepts every remaining problem of this kind and any warnings, for that publish only. It appears only once nothing that always blocks is left.

Each accepted problem is recorded with the version you publish.

What publishing does

Publish saves your edits, checks the draft again, and publishes exactly what was checked. If the set changed meanwhile (another tab), it's checked again first. The published copy is private: it appears in your library and only you can study it until you share it. Republishing makes a new version (what changes for learners).