Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Glossary

The words the manual uses, each with the page that says more.

WordMeaning
answerA target’s value for a variable, kept in .devset/answers.toml. Templates
baseThe bytes devset last wrote for a file: what an update merges against. State
blockA marked stretch of a text file that a profile owns. Parts of a File
bundleA profile with nothing but requirements. Composing Profiles
collectionA source published for others, which may describe itself in collection.toml. Publish a Collection
conflictWhere a profile’s change and a local edit touch the same lines; left beside the file, in .devset/conflicts/. Update and Resolve Conflicts
driftA file devset manages that no longer matches what the profile says. In CI
featureAn optional, additive capability of a profile. Composing Profiles
gateAn entry’s when: the conditions under which it applies. Gates and Scaffolds
keysThe keys of a TOML, JSON or YAML file that a profile owns. Parts of a File
layerOne active profile of a target: configured by it, or required by a profile. Composing Profiles
lock.devset/lock.toml: the commit each source resolved to, and each layer’s features. State
partThe keys, or the block, a profile owns in a file the target otherwise owns. Parts of a File
policyHow devset treats a file’s local edits: owned, merge or once. Profiles
profileA versioned bundle of files: profile.toml, and files/ beside it. Profiles
requirementA profile another builds on, by name. Composing Profiles
scaffoldA group of starter files, written once when the target has none of its own. Gates and Scaffolds
sourceWhere profiles come from: a git repository at a ref, or a directory. Composing Profiles
starterA file’s first content, written where the target has none, before a profile’s part joins it. Parts of a File
targetThe directory devset applies profiles to, a repository or not. State
templateA file devset renders with the target’s answers and its graph before writing it. Templates
variableA value a profile asks the target for. Templates