Skip to main content
A Document is something you write in Saphion: a brief, a method statement, meeting notes, a report. Several people can edit it at once, comment on any passage, and ask Beacon to write or change it. It lives in Saphion, in Creations or in a Project, and you can export it to Word, PDF or Markdown.
Everyone with a Platform seat can make a Document. What you can do in one depends on your access to it.

Make a Document

Choose Creations in the sidebar, then New, then Document. A blank Document opens at once, called “Untitled Document”. Inside a Project, use the New choice on the Project’s Creations tab, and the Document is filed there.Click the title to name it. A blank Document says “Start typing, or ask Beacon to…”. Select ask Beacon to open the ask box.

Write in a Document

Click anywhere and type. Your changes save as you go: the top of the page says Saving… while it happens and Not saved if it fails, and offers Try saving again. Other people editing at the same time appear as carets with their names, and Recent active viewers at the top shows who has the Document open.

The toolbar

If you can edit the Document, a toolbar sits above the text. From the left: Your font, width and tab choices are your own view. They are kept in this browser for that Document, apply to every tab of it and are not shared with anyone.

Add a block

Press / on an empty line, or choose Insert, to open the list of blocks. Keep typing to narrow it. You can also start a line with #, ##, ###, -, 1., [], > or three backticks to make a heading, list, checklist, quote or code block as you type. A Prompt is a request readers can run with Beacon about the Document. Agent instructions is guidance Beacon reads whenever it works on that Document. To move a block, press Alt+Shift+Up or Down. Blocks such as tables, images and charts also have a grip beside them to drag.

Make a checklist item an Action

Hover a checklist item that is not yet linked to anything and choose Make this an Action at its right. The New action sheet opens already filled from the item: its words are the name, a person mentioned in it is the assignee and a date in it is the due date. Choose Create and the item links to the new Action, so ticking the item finishes the Action. You need to be able to edit the Document. See Actions.

Format selected text

Select some words to bring up a bar above them: Ask Beacon, Comment, React, the style menu (Aa: Text, Heading 1 to 3), bold, italic, underline, strikethrough, inline code, highlight (with a choice of colour), a list menu and Link (Ctrl+K, or ⌘K on a Mac).

Use tabs

A Document can have several tabs, such as a main report and an appendix. Choose Tab 1 (the number is the open tab) on the toolbar to open the list.
  • Select a tab to open it. Choose the arrow beside a tab to see its headings, and select a heading to jump to it.
  • Type in New tab… and press Enter to add one.
  • Choose Options beside a tab for Rename, Duplicate, Add subtab, Copy link, Move (up, down, make top-level or make a subtab of another tab) and Delete tab.
The first tab is the Document itself: it cannot be deleted or given subtabs. Deleting any other tab moves it to the Bin, where a person who can manage the Document can restore it. See Bin and restore.

Comment and react

Select words and choose Comment, or press Ctrl+Alt+M (⌘⌥M on a Mac). Write the comment and send it. It anchors to those words. Comments open in a Comments sidebar beside the text. The sidebar shows how many threads are open and filters them: Open, Resolved or All. Resolve a thread when it is dealt with, and Reopen it if it comes back. A thread whose words have since been edited is marked Text changed. Press Alt+Shift+C (⌘⌥⇧C on a Mac) to hide or show all comments, or use Hide comments in the sidebar’s menu.
If you can edit the Document, tick Send to Beacon, or write @Beacon, in a comment and Beacon makes the change you asked for and answers in the same thread.

Ask Beacon to write or change a Document

Beacon writes in the Document as you watch. It outlines first, then fills one section at a time. Beacon’s caret is visible in the text while it works.
  • Ask Beacon here in the block list asks about the place where your caret is.
  • Ask Beacon on selected text opens a card titled Ask Beacon to edit, with “Tell Beacon what to change” and one-tap edits: Make it shorter, Make it simpler and Fix spelling and grammar. The suggestions change with what you selected, for example Say this more simply for text, Do these add up? for a table or Write a caption for an image.
  • Ask Beacon in the side chat works on the Document you have open.
Beacon keeps your work. If you edit a passage while it is writing, your edit wins and Beacon reads again before it carries on. It changes another person’s words only when you selected them or they carry your comment. When it finishes, a message says “Beacon changed” the Document, and Version history shows exactly what changed.

See and restore earlier versions

Open the title menu and choose Version history. It lists versions newest first, each with when it ended, who made it and how many changes it holds. A version Beacon made in a chat says “Made in a chat”. Choose a version to see it in place of the Document. Show changes marks what changed. Restore this version makes it the newest version. Back to the document leaves without changing anything. Version history is offered to people who can edit the Document.

Share and export

  • Share opens the Share dialog, where you add people and choose what each can do. A new Document is private to you until you share it. See Sharing and access.
  • Export, the second tab of the Share dialog, downloads the Document as Word, PDF or Markdown. Pending changes are saved first, so the file is what you see.
  • Copy as Markdown in the title menu copies the Document’s text as Markdown without making a file.
  • Copy link copies an address that opens only for people who can already open the Document.
  • Pin, in the title menu, adds the Document to your favourites. See Favourites and Creations.
  • Files & sources, in More document options, lists the files the Document names and the exports already made from it.

Rename, archive and delete

The title menu has Rename, Archive and Delete. Archive keeps the Document, out of your lists, until you restore it. Delete moves it to the Bin for your plan’s Bin days. See Bin and restore.

How it works

  • Saving is automatic. If Saphion cannot save, the page says Not saved and offers Try saving again.
  • Your edit wins. If you and Beacon change the same passage, yours is kept.
  • Access. A Document filed in a Project follows the Project’s people. One in your Creations follows who you share it with.

Ask Beacon

“Draft a method statement for the Alder Wharf roof works. Start with an outline and wait for my comments.” Beacon outlines first, then fills each section. “Answer the comment on the second table.” Beacon reads the comment thread, makes the change and replies there.

FAQ

A Document you make on your own is Private until you share it. One made in a Project or a Workspace belongs to that place, and everyone in it can open it, unless you or a Manager of the place lock it, which makes it Private again. A request to Beacon never gives anyone access.
Yes. You each see the other’s caret. Edits are merged as you type, and Recent active viewers shows who is there. It does not lock the Document.
You may have view access only. Ask the person who manages the Document to change what you can do.
A Document is written and edited in Saphion with others. A Word file is a file you download or send. Export a Document to Word when you need one. See Word documents and PDFs.
Yes, if it was in an earlier version. Open Version history, find a version from before the change and restore it.