# Docs

Every document written at Envisioning or from Starlings, in one place.

## Where

| Client | Reach it |
| --- | --- |
| Mac | ⌘5 |
| iPhone and iPad | The Docs tab |
| Web | `/docs` |

On Mac, opening a document adds its title to the Docs tab, such as `Docs — Proposal`.

On iPhone and iPad, use **Save link** in the Docs tab, or from a subject's Documents view to file the link on that subject. The Links row lists saved links. A saved link keeps the URL and page metadata, with space for your notes. It does not archive the full page. A saved link is yours alone until you file it on a subject or share it; the web marks it **Only you**. A link saved from a subject's Documents view is filed from the start.

Connect Docs once, in Settings → Account, beside Core. If Docs is not connected, the surface says so and shows nothing.

## Shape

When signed out on web, the page shows a centered card with the Docs heading and one sign-in action.

The rail has Graph, Recent, Unfiled, one row per category, By project, By lead, Folders (the top-level folders) and Library (the mirrored writing). Each block folds, and the fold is remembered on that device; the order and the blocks that hide while empty are the same on Mac, iPhone, iPad and web. The list sits in the middle and the editor in the inspector. **Documents** on a subject in Work shows the same documents for that one subject.

Graph shows up to the 5,000 most recent accessible documents as nodes, with a line for each resolved wikilink. Folder colors and grouping are shared across Mac, iPhone, iPad and web; links pull related documents together within their folder groups. Toggle a folder to focus on the remaining groups. Select a node to open its document. The layout is live: it unfolds as the graph loads, links pull documents into place as document details arrive, and it comes to rest on its own. Drag a node to pull its linked documents along; point at one to light up its links and fade the rest. Titles appear as you zoom in, sooner for well-linked documents. The view follows Fit until you pan or zoom, and Fit hands it back. Zoom ranges from 25% to 400% of Fit on every surface.

Unfiled lists documents with no category and no project or lead that still sit in the default folder. The row shows only while there is something to file.

On the Mac, ⌘-click adds a row to the selection and ⇧-click selects a range. Drag documents onto a rail row to file them there: a folder moves them, a project or lead links them, a category sets it.

## Floating (Mac)

A document can open in its own small window. You can keep it in view and edit it while you work in other apps. A pinned window stays on top of every app and on every Space. An unpinned window is an ordinary window. When Starlings starts again, it reopens a floating document where it was. To put it away, close its window.

You edit a document in one place at a time. While it floats, the inspector on it offers **Bring to Front** instead of a second editor.

## Controls

| Control | Does | Shortcut |
| --- | --- | --- |
| New document… | A document in the open folder | ⇧⌘N |
| Save link | Saves an HTTPS URL with its page metadata. The document body is for your notes; the page's full content is not archived | — |
| Write / Preview | Markdown in, rendered out | — |
| File | In a row's menu: Folder, Category, Project, Lead. A tick means the document is already filed there. Pick a ticked project or lead to take it off. On the Mac it applies to every selected row | — |
| Star / Unstar | Keeps a document or folder in Home's QUICK ACCESS list | document row menu or editor; folder row menu. A top-left star badge marks starred rows |
| Category | Sets the row's category | — |
| Add a project, lead or partner | Links the document to a subject. The folder is where the document is stored. The subject is what it is about | — |
| Show Right Sidebar / Hide Right Sidebar | Passage comments for the open document. On the web, one header control toggles a column on a wide window or a side sheet on a narrower one; it defaults to closed and remembers an open panel per surface | header on web |
| Copy link | The document's address | — |
| Move to… | In a row's menu or the document's menu on the web: pick a folder from the list; type to filter it | — |
| Rename… | In a row's menu: a new title for the document | — |
| Archive | In a row's menu or the document's menu: the document leaves every list; Docs keeps it | — |
| Keep mine / Take theirs | Resolving a save that collided with another editor's | — |
| Hide the rail and the list | The editor alone | — |
| Graph | Opens the Docs graph: documents as nodes, wikilinks as connections, folder groups as colors | — |
| Zoom in / Zoom out / Fit | Changes the graph scale or frames the visible nodes | scroll or pinch to zoom at the pointer on web; pinch to zoom on Mac, iPhone and iPad; drag the background to pan and a node to move it on every surface |
| Open in Floating Window | In a row's menu: the document in a window of its own (Mac) | — |
| Float Document | The document open in the inspector, in a window of its own (Mac) | ⇧⌘F |
| Keep on Top / Unpin from Top | The floating window's pin: above every app, or an ordinary window | — |
| Bring to Front | In the inspector, for a document that already floats | — |

Mirrored bodies (newsletters, reports, research) are read-only, with **Open source** to where they live.

## Row menus (web)

Every Docs row has a menu. Open it with the `…` on the row, a right-click, or ⇧F10. The `…` shows when the pointer is over the row or the row has focus; on a touch screen it is always there. A top-left star badge marks a starred document or folder; Star / Unstar stays in the row menu.

| Row | Menu |
| --- | --- |
| A document, in the list or a subject's Documents pane | Open, Open page (a saved link), Copy link / Rename…, Move to… / Archive / Star |
| The open document's menu | The same, without Open and Star |
| A rail view, project or lead | Open, Copy link |
| A folder | Open, Copy link / Star |

A mirrored document has no Rename…, Move to… or Archive. A saved link copies the page it points at. The web has no menu for more than one selected row yet.

## Leads to

The subject a document is about, in [work](work.md).