Spools
Every project is a spool. Spools hold spools.
A spool is Heddle's repository: the thing you clone, capture into, and publish. Everyone has a personal spool at their handle, and a spool can hold other spools the way a folder does.
01 · Structure
One path per project.
Spools are addressed by path, heddleco/atlas, and a spool
can hold others: heddleco/atlas/docs. Related work sits
under one name instead of across a list of unrelated repositories.
When a child spool outgrows its parent, promote it to top level. A spool can only be deleted once it's empty, so removing a parent never takes the spools inside it with it.
Before
- anapersonal spool
- heddleco
- atlas
- docs
- site
After promoting docs
- anapersonal spool
- heddleco
- atlas
- site
- docstop level
Delete heddleco Not while it has spools inside it.
02 · Access
Invited, with a role.
People join a spool by invitation. Access is a grant on a spool, to a person, as reader, writer or administrator, and a grant can include the spools inside it, so one invitation can cover a whole project.
Each spool is public, visible to its members, or private, and a spool setting decides the default visibility of new work.
| Spool | ana | mara | jun |
|---|---|---|---|
| heddleco Public | administrator direct | · | · |
| atlas Members | administrator from heddleco | writer direct | reader direct |
| docs Public | administrator from heddleco | writer from heddleco/atlas | · |
| site Private | administrator from heddleco | · | · |
heddleco and mara's on heddleco/atlas include the spools inside; jun's covers heddleco/atlas only.03 · Review
Rules for landing live on the spool.
A review policy decides what a change needs before it lands: approvals, approvals from named groups, a minimum reviewer role, and checks that must pass. It can refuse the author's own approval, apply only to certain paths, and reset or expire approvals when the revision changes or time passes.
The approval groups it names are defined on the spool too.
heddleco/atlas- Required approvals
- 2
- Approval groups
- design · 1 approval
- Minimum reviewer role
- writer
- Author's own approval
- doesn't count
- Required checks
test- Paths
src/**- On a new revision
- approvals reset
Your handle is your first spool.
Hosted Heddle is invite-only during early access. Reserve a handle and we'll hold it for you. The CLI works on the Git repo you already have, without an account.
Already have an invite? Redeem it