Notes, comments & discussion

Context lives next to the data in Dataerai. There are three distinct surfaces, and they serve different purposes:

​

Notes

Each asset has a shared Public note — a free-form Markdown document that renders as formatted prose. Use it for the things a future reader (including you) will want to know: how the data was produced, what the columns mean, known issues, and links to related work. The Public note is part of the asset itself rather than a conversation. When sample notes are enabled for your workspace, the Notes tab also has Private and Shared sub-tabs:

• Public is the asset’s shared Markdown note.
• Private is your personal note on the sample. Only you can read and edit it.
• Shared contains notes you wrote for selected people or groups, plus notes others shared with you. You can edit and delete notes you authored. Notes shared with you are read-only.

To share a sample note, open Shared, create or select a note, choose Manage, then add people or groups to the audience. Removing all recipients from the audience leaves the note visible only to you until you share it again.

​

Comments

The Comments tab is a threaded discussion. Anyone with access can post a comment and reply to others, so questions and decisions stay attached to the asset instead of scattering across email or chat. Mention a teammate with @ to pull them in — they get a notification pointing back to the exact comment.

​

README

Collections and projects have a README — a Markdown document that introduces the whole group of data: what it contains, how it’s organized, and how to use it. Open a collection and switch from the Data tab to the Readme tab to read or edit it. It’s the natural place for an at-a-glance overview that individual asset notes can’t give a collaborator landing on a group of data.

​

Next steps