github.com/eliastor/durgaform@v0.0.0-20220816172711-d0ab2d17673e/internal/command/workdir/doc.go

// Package workdir models the various local artifacts and state we keep inside
// a Durgaform "working directory".
//
// The working directory artifacts and settings are typically initialized or
// modified by "durgaform init", after which they persist for use by other
// commands in the same directory, but are not visible to commands run in
// other working directories or on other computers.
//
// Although "durgaform init" is the main command which modifies a workdir,
// other commands do sometimes make more focused modifications for settings
// which can typically change multiple times during a session, such as the
// currently-selected workspace name. Any command which modifies the working
// directory settings must discard and reload any objects which derived from
// those settings, because otherwise the existing objects will often continue
// to follow the settings that were present when they were created.
package workdir