The files in this folder detail the Dev Container Specification.
We add any proposal to the proposals folder, only if the proposal is accepted. It stays in that folder until the implementation is in progress. Once code/schema changes are released, we move it into the specs folder.
Note: Our contributing.md documents guidelines on contributing to the spec, as well as labels (proposal and finalization) defined for this process for GitHub issues.
There are several main specs in this folder, outlining the key top-level behavior of dev containers, Templates, and Features:
- Main dev container spec
- Dev container metadata reference
- Main Templates spec
- Templates distribution spec
- Main Features spec
- Features distribution spec
- Tools that support the spec
The remainder of the files in this folder outline specifications for specific dev container behaviors. Each file includes links to when the proposal was first discussed and when it was merged into the Dev Container CLI or schema.