You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
You may learn about Features at [containers.dev](https://containers.dev/implementors/features/), which is the website for the dev container specification.
28
20
29
21
## Usage
30
22
31
-
To reference a feature from this repository, add the desired features to a `devcontainer.json`. Each feature has a `README.md` that shows how to reference the feature and which options are available for that feature.
23
+
To reference a Feature from this repository, add the desired Features to a `devcontainer.json`. Each Feature has a `README.md` that shows how to reference the Feature and which options are available for that Feature.
32
24
33
25
The example below installs the `go` and `docker-in-docker` declared in the [`./src`](./src) directory of this
34
26
repository.
35
27
36
-
See the relevant feature's README for supported options.
28
+
See the relevant Feature's README for supported options.
37
29
38
30
```jsonc
39
31
"name":"my-project-devcontainer",
@@ -51,7 +43,7 @@ See the relevant feature's README for supported options.
51
43
52
44
The `:latest` version annotation is added implicitly if omitted. To pin to a specific package version
53
45
([example](https://github.com/devcontainers/features/pkgs/container/features/go/versions)), append it to the end of the
54
-
feature. Features follow semantic versioning conventions, so you can pin to a major version `:1`, minor version `:1.0`, or patch version `:1.0.0` by specifying the appropriate label.
46
+
Feature. Features follow semantic versioning conventions, so you can pin to a major version `:1`, minor version `:1.0`, or patch version `:1.0.0` by specifying the appropriate label.
55
47
56
48
```jsonc
57
49
"features": {
@@ -63,7 +55,7 @@ feature. Features follow semantic versioning conventions, so you can pin to a ma
63
55
64
56
The [devcontainer CLI reference implementation](https://github.com/devcontainers/cli) (or a
65
57
[supporting tool](https://containers.dev/supporting)) can be used to build a project's dev container declaring
-[`src`](src) - A collection of subfolders, each declaring a feature. Each subfolder contains at least a
92
+
-[`src`](src) - A collection of subfolders, each declaring a Feature. Each subfolder contains at least a
101
93
`devcontainer-feature.json` and an `install.sh` script.
102
94
-[`test`](test) - Mirroring `src`, a folder-per-feature with at least a `test.sh` script. The
103
95
[`devcontainer` CLI](https://github.com/devcontainers/cli) will execute
104
96
[these tests in CI](https://github.com/devcontainers/features/blob/main/.github/workflows/test-all.yaml).
105
97
106
98
## Contributions
107
99
108
-
### Creating your own collection of features
100
+
### Creating your own collection of Features
109
101
110
-
The [feature distribution specification](https://github.com/devcontainers/spec/blob/main/proposals/devcontainer-features-distribution.md) outlines a pattern for community members and organizations to self-author features in repositories they control.
102
+
The [Feature distribution specification](https://containers.dev/implementors/features-distribution/) outlines a pattern for community members and organizations to self-author Features in repositories they control.
111
103
112
-
A template repo [`devcontainers/feature-template`](https://github.com/devcontainers/feature-template) and [GitHub Action](https://github.com/devcontainers/action) are available to help bootstrap self-authored features.
104
+
A template repo [`devcontainers/feature-template`](https://github.com/devcontainers/feature-template) and [GitHub Action](https://github.com/devcontainers/action) are available to help bootstrap self-authored Features.
113
105
114
106
We are eager to hear your feedback on self-authoring! Please provide comments and feedback on [spec issue #70](https://github.com/devcontainers/spec/issues/70).
115
107
116
108
### Contributing to this repository
117
109
118
110
This repository will accept improvement and bug fix contributions related to the
0 commit comments