Initial commit

spec/20-projects.md

@@ -0,0 +1,16 @@
+# 20. Projects
+
+A project, `scienting-project/1`, is the unit a team works in.
+
+| Part | Holds |
+| --- | --- |
+| `key`, `store`, `name`, `description` | Its identity. |
+| `members` | People with a `role` (`owner`, `editor`, `reader` or `guest`) and the roster keys they sign with. |
+| `documents` | The project's documents, each with the `reason` it is included, `tags`, and a reading `status` per member: `unread`, `reading` or `read`. |
+| `paths` | Reading paths: ordered steps through documents, nodes, claims and layers, for onboarding a student or preparing a reading group. |
+| `layers`, `datasets`, `views`, `drafts` | What the project holds. |
+| `claims` | The Lode namespace or bundle it uses. |
+| `settings` | The digit rule for targeted F3 ([8.10](08-fidelity.md#810-targeted-f3)), the drift threshold ([6.6](06-anchors.md#66-drift)), the spot-check rate and minimum ([8.8](08-fidelity.md#88-spot-checks)), what happens when a right is unknown (`refuse`, the default, or `warn`), and the stage requirements in use. |
+
+Projects are small on purpose: everything about them is designed for hundreds of documents, not millions.
+Owners sign policies ([14.2](14-rights.md#142-effective-uses)) and may revoke receipts ([8.7](08-fidelity.md#87-revocations-and-the-roster)).