mirror of
https://github.com/ZTatman/myst.git
synced 2026-11-21 12:27:59 +00:00
11 lines
1.1 KiB
Markdown
11 lines
1.1 KiB
Markdown
# Firebreak glossary
|
|
|
|
A **share link** opens a **snapshot**. A **grant** is the internal record Firebreak checks to decide whether to allow access.
|
|
|
|
| Term | Meaning | Where it belongs |
|
|
| --- | --- | --- |
|
|
| **Snapshot** | A repository's content at a specific commit SHA. The branch helps users find a commit; it does not change what a link opens later. | Picker, preview, and viewer copy. A snapshot doesn't need a separate database model. |
|
|
| **Share link** | The URL someone copies and sends to let others view a snapshot. | Dashboard copy, share-link API names, and `/links` routes for creating and managing links. |
|
|
| **Grant** | The stored access record: the repository and commit SHA, expiration, revocation, and any recipient restriction. | The `Grant` model, `grants` table, and backend authorization code. Use **share link**, not **grant**, in user-facing copy. |
|
|
|
|
The dashboard's snapshot picker lives under `/dashboard/snapshot-picker`. Selecting or clearing a preview does not create, publish, or revoke a share link. Existing JSON repository listings stay under `/links/repositories` for compatibility.
|