Skip to content

Comments and attachments

The side panel sits beside a document page. Use it to discuss the document in comments and to keep its files as attachments. Comments take markdown, so you can format text, mention people, and link other documents.

  • Read access. You need read access to the document. Without it, Facet does not show the document or the panel.
  • Create rights. You need the right to create on the doctype to comment or attach. A missing right hides the controls on this page.
  • Panel lists. A doctype decides which lists the panel carries. A type with no lists shows one column only.

Open a document. The panel stands on the right side of the page and stays in place while you scroll the document.

A doctype can carry more than one list, for example Comments and Files. Each list then shows as a tab with a count. The count updates when you add or remove an entry.

In a window of 1100 pixels or less, the panel moves below the document.

Open the Comments tab. The composer sits at the bottom and stays visible while you scroll the thread.

Type in Write mode. The editor gives you headings, tables, code, and links. Select Preview to read the result. Select Markdown to edit the raw text.

To put a file inside a comment, drop or paste it into the editor. An image shows in the comment. Another file shows as a file link. Facet uploads the file when you send.

Select Comment to send. While Facet saves, the button shows Posting…. Your comment then joins the end of the thread with your name, your picture, and the time.

Type @ and start to type a name. A list opens with people and documents. You can also type [[ to open the same list.

Pick an entry. The editor inserts a chip that shows the current name of the person or document. The person you mention receives a notification.

The list starts with the document’s domain. Use the All domains row to search everywhere. Press Esc to close the list; the text you typed stays.

The list does not open when @ sits inside a word, for example in an address.

Reply. Select Reply on the comment. A chip above the input shows Replying to and the name. Type your reply and select Comment. To stop, select the cancel button on the chip.

Facet nests replies under the comment they answer. The nesting shows to three levels. A deeper reply moves up and carries a replying to note. A thread with replies shows Expand replies or Collapse replies, with the number of replies.

Edit. Select Edit on your comment. Change the text and select Save.

Delete. Select Delete and confirm. Facet asks you to confirm, because it cannot undo the delete. When someone deletes a comment that has replies, Facet keeps the replies and shows a placeholder in place of the deleted comment.

These controls show on your own comments. Your role decides this. Facet checks your rights again when you save.

Open the Files tab and select Choose file. The name field fills with the file name. Change it if you want.

Select Attach. While Facet uploads, the button shows Attaching…. The file then lists with its type, its size, the time, and the account that uploaded it.

Rule Detail
Largest file 50 megabytes by default. Your administrator sets the limit.
File types Any
Same content Facet stores identical content once and reuses it.
Storage Facet keeps file bytes in its file store, outside the document.

6. Download, rename, or remove an attachment

Section titled “6. Download, rename, or remove an attachment”

Download. Select the download control on the row. The file opens in a new tab. Facet checks your access at each download.

Rename. Select the rename control, change the Attachment name field, and save.

Remove. Select the delete control and confirm.

In Write mode you type @ and pick from the list. In Markdown mode the same comment looks like this:

Checked the totals with [@Marie Dubois](urn:facet:iam:Account:01JCATPMKP4N82GVG2J7K4MHZZ).
| Item | Amount |
| ---- | ------ |
| Licence | 480 |

The doctype carries no panel lists. Ask the domain author to add comments to the type. See Sidecars (comments, attachments).

In a narrow window, look below the document. The panel sits there.

Your role cannot comment on this doctype. Facet shows: You cannot comment on this document. Ask your administrator for the comment right.

  1. Check the file size. The file may be larger than the size limit. The default limit is 50 megabytes. Use a smaller file, or ask your administrator to raise the limit.
  2. Check your rights. Your role may also lack the attach right. Facet then shows: You cannot attach files to this document.

You can change only your own comments. A moderator role can act on any comment. Ask your administrator if you need this right.