diff --git a/config-linux.md b/config-linux.md index 2269c4d42..e9df9377b 100644 --- a/config-linux.md +++ b/config-linux.md @@ -614,7 +614,7 @@ The [Shared Subtrees][sharedsubtree] article in the kernel documentation has mor ## Masked Paths **`maskedPaths`** (array of strings, OPTIONAL) will mask over the provided paths inside the container so that they cannot be read. -The values MUST be absolute paths in the [container namespace][container-namespace2]. +The values MUST be absolute paths in the [container namespace](glossary.md#container_namespace). ###### Example @@ -627,7 +627,7 @@ The values MUST be absolute paths in the [container namespace][container-namespa ## Readonly Paths **`readonlyPaths`** (array of strings, OPTIONAL) will set the provided paths as readonly inside the container. -The values MUST be absolute paths in the [container namespace][container-namespace2]. +The values MUST be absolute paths in the [container namespace](glossary.md#container-namespace). ###### Example @@ -648,8 +648,6 @@ The values MUST be absolute paths in the [container namespace][container-namespa ``` -[container-namespace2]: glossary.md#container_namespace - [cgroup-v1]: https://www.kernel.org/doc/Documentation/cgroup-v1/cgroups.txt [cgroup-v1-blkio]: https://www.kernel.org/doc/Documentation/cgroup-v1/blkio-controller.txt [cgroup-v1-cpusets]: https://www.kernel.org/doc/Documentation/cgroup-v1/cpusets.txt diff --git a/style.md b/style.md index 0d3f10d82..1d42043e7 100644 --- a/style.md +++ b/style.md @@ -8,12 +8,12 @@ For example, this paragraph will span three lines in the Markdown source. ## Traditionally hex settings should use JSON integers, not JSON strings -For example, [`"classID": 1048577`][class-id] instead of `"classID": "0x100001"`. +For example, [`"classID": 1048577`](config-linux.md#network) instead of `"classID": "0x100001"`. The config JSON isn't enough of a UI to be worth jumping through string <-> integer hoops to support an 0x… form ([source][integer-over-hex]). ## Constant names should keep redundant prefixes -For example, `CAP_KILL` instead of `KILL` in [**`linux.capabilities`**][capabilities]. +For example, `CAP_KILL` instead of `KILL` in [**`process.capabilities`**](config.md#process). The redundancy reduction from removing the namespacing prefix is not useful enough to be worth trimming the upstream identifier ([source][keep-prefix]). ## Optional settings should not have pointer Go types @@ -120,8 +120,6 @@ The URL for the Open Containers link above is: https://github.com/opencontainers ``` -[capabilities]: config-linux.md#capabilities -[class-id]: config-linux.md#network [integer-over-hex]: https://github.com/opencontainers/runtime-spec/pull/267#r48360013 [keep-prefix]: https://github.com/opencontainers/runtime-spec/pull/159#issuecomment-138728337 [no-pointer-for-boolean]: https://github.com/opencontainers/runtime-spec/pull/290#r50296396