Adding content

Create the documents and write the real content into their fields. A document's place in /documents/ is the URL of its page. A file name that starts with . hides the document as a draft: it cannot be referenced and will not be rendered into a page. See Documents.

Do

• Follow each field's description for specific instructions (e.g. tone, length).
• Reference content that already exists instead of copying it.
• Put a new document next to similar ones, so its URL follows the same pattern.
• Keep shared parts like the navigation as fragments in a document without a component (e.g. Settings.yml).

Don't

• Don't write HTML into a plain string field. That's what richtext is used for.

FAQ

Which file format do I pick? The same as similar documents. Otherwise .md for running text like blog posts, .yml or json for structured pages.

Do I have to set the _id? No, one will be added when the file is created.

Can editors change pulled documents? Yes. A pull only overwrites only the fields the other system owns, anything else stays.

Example

/documents/index.yml             /
/documents/lessons/stealth.yml   /lessons/stealth
/documents/shop/black-gi.yml     /shop/black-gi
/documents/site.yml              no page (no component)