What is Docs?

Docs is where the writing lives — briefs, meeting notes, processes, client handbooks, anything longer than a task description. Open it from Docs in the left rail.

It is a tree, like the rest of Kokar, but its own one: what you put in Docs is organised separately from your spaces and projects, and the two only meet when you choose to connect them.

Two kinds of thing, and the shelves they sit on

A page is a document you write in Kokar. It has a title, an icon, and a body you edit in a rich editor — headings, lists, tables, images, files, callouts. A page can hold sub-pages, one level deep, which is how a long document splits into chapters.

A file is something uploaded that sits in the tree as an item of its own. Opening it shows the file rather than an editor: images and PDFs preview inline, everything else gets a download button. A file is a leaf — nothing goes inside it.

Both live inside containers, which nest three deep:

Space → Folder → Subfolder

Those are the same words your main sidebar uses, on purpose — "it's in the Brand folder" means the same thing in either place.

Docs
└── Brand                          ← space
    ├── Guidelines                 ← folder
    │   ├── Tone of voice          ← page
    │   │   └── Examples           ← sub-page
    │   └── Logo usage             ← page
    └── logo-pack.zip              ← file

How deep things go

Nothing forces you to use every level. A perfectly good Docs tree is three spaces with pages directly inside them.

Getting around

The Docs sidebar has three parts.

Quick views at the top open a flat list of everything you can reach, with no tree to expand:

Each row shows whether the item is team shared or private, and when it was last touched.

Favorites is your own shortcut list. Star a page or a file — from its header, or from the ⋯ menu in the tree — and it appears here for you alone. Folders cannot be starred, since there is nothing to open.

Docs underneath is the tree itself. Expand a container to load what is inside it, and the ⋯ next to the + holds Show archived for when something has been put away.

Where docs turn up outside Docs

A page does not have to stay in the Docs section.

• Pinned to a location. Pin a page or file to one of your workspace spaces, folders or projects and it appears in the main sidebar under it — and the people who can see that location get access to the doc. It stays in the Docs tree as well; a pin is a second place to find it, not a move.
• Linked to a task. A task's Docs & Pages tab links pages and files to the work they belong to, so the brief and the job that came out of it stay together.
• Starred. Favorites put it at the top of your Docs sidebar.

Writing, saving, and other people

There is no save button and no publish step. What you type is stored as you type it, and anyone else with the page open sees it appear.

If a sync problem ever does happen, Kokar tells you so and asks you to refresh rather than letting you type into a page that isn't saving.