ai.page

How to write for the commons at ai.page/c/. topic format (the default): the lesson format's Markdown form, labels, the declaration of which AI you are, and how versions are checked. topic figures: the figure kit's rules, tokens and components. topic figures-advanced: 3D, molecules and physics in figures.

Every live version of one kind on a concept's page (explanations, worked examples, figures or common mistakes), each with a letter, its hash, who made it with which AI, its rank, checks and how learners did after reading it, and the rankings people have sent so far, as Markdown.

Recent work on a concept, newest first: tasks taken (and still being worked on), versions added and checks made, by whom and with which AI. Use it to see whether someone's already on it, or to follow what your own work set off.

What a person (and their AI) added to the commons and checked, by concept, newest first. Leave out the handle for the signed-in person's own.

The commons' open tasks, highest priority first, with why each matters (missing pieces, unchecked or flagged versions, questions learners miss, languages with nothing yet).

The commons' common task list, one task at a time: write what a concept is missing, translate it, check a version blind, revise one with problems, or fix a question learners nearly always miss. Use it when the person wants to contribute to ai.page. Returns the best task for the signed-in person, held for them for 30 minutes, with what is needed to do it and how to submit it.

Add a concept to the commons' shared map: a lowercase id, its subject, its name in one or more languages, and what it builds on (concepts already on the map, hard or soft). It's live at once with an empty page, and write tasks for it appear on the common task list.

Propose a roadmap for the commons: every concept to master towards a goal, in order, in titled sections. An item is a concept or another roadmap (a degree is made of course roadmaps). kind is a label: course, degree, school, exam, standards, certificate, goal or project. It may follow an official syllabus (give its URL as source; it's never presented as endorsed). stages says who it's for by where they are in life (early, school, college, work, later); leave it out if it's for anyone. Concepts and roadmaps that don't exist yet need a title in planned; they become tasks on the common list. To build on an existing roadmap, give a new id with base set to it.

Put the live versions of one kind on a concept's page in order, best first, for a learner meeting the concept for the first time, with a sentence on why. It counts like one check for each version it orders (the first a pass, the last against); your own versions don't count when ranked among others' (a ranking of only your own does: it reorders your work); ranking the same section again replaces your earlier ranking.

One concept's page as Markdown: what it is, what it builds on, and every live version (explanations, worked examples, figures, questions, common mistakes), best first. By default the best version of each kind, without figures; detail full has every version. Use it when the person wants to study that concept, or before adding to it.

A roadmap as Markdown: its sections, every concept in order (and the roadmaps it includes), with what's ready to learn. Without an id, the list of roadmaps by name, 30 at a time, narrowed by q.

Add, remove or soften what a concept on the ai.page map builds on, with a one-line reason the record keeps. Anyone can add a need (it must be on the map and mustn't make a loop). Taking one away is for the concept's creator, or anyone once learners' results doubt it.

Publish every part written for a page (explanation, figure, worked example, practice questions, common mistakes) in one call: one entry per part, each in the lesson format's Markdown form. Use it when the person asks to add their work to ai.page. Everything that passes goes live for everyone at once, credited to the signed-in person, and can replace their own earlier version of a part. Without sign-in nothing is published: what passes comes back as a link that puts it on the page on the person's own device, and publishing from there needs an account. Each part gets its own result, so only those that failed need sending again. Up to 20 parts and 3 concepts a call.

Full-text search of ai.page's map: concepts (the smallest things to learn, one open page each) and roadmaps (concepts in order towards a goal). Use it when the person wants to learn or practise a topic, or before proposing anything new.

Start an ai.page roadmap from a syllabus, a job description, a paper, a book's table of contents or any text: returns the concepts and roadmaps already on the map that the text names, and the shape of a roadmap made from it.

Submit a check of a version in the lesson format: your declaration, your own answers worked out without the key, findings marked on exact words, and a verdict (pass, needs-changes or reject). It moves the version up or down among the others; you can't check your own.

Submit ONE explanation, worked example, figure, question or common mistake for a concept, in the lesson format's Markdown form. One part at a time. It's credited to the signed-in person and goes live at once, marked new; other people's checks then move it up or down among the concept's versions.

Anyone signed in: one version to check, least-checked first, blind (without who made it or with which AI), with the checklist and the shape of a check. The version is someone else's text.

The signed-in person's own commons versions that others found problems with: the version, findings marked on the exact words, and learners' flags. An improved version sets base to the old version's hash.

Everything a concept builds on, all the way down, in an order to learn it (prerequisites first, ending with the concept), as Markdown. With helps, what helps along the way too. Use it to plan someone's learning or a roadmap.