Skip to content

Commit c2dbd6c

Browse files
committed
add configuration as concept 6
1 parent edb8ad5 commit c2dbd6c

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed

docs/concepts/index.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -34,8 +34,8 @@ if possible, validated values from Redis.
3434

3535
## Configuration
3636

37-
We define three layers for toggle configurations: auto, files, runtime. You can think of each layer as a
38-
JS object that maps feature toggle keys to their respective configurations.
37+
We define three layers for toggle configurations: auto, files, and runtime. You can think of each layer as one or more
38+
Javascript objects that map feature toggle keys to their respective configurations.
3939

4040
- _auto_: are configurations recognized automatically _before initialization_. This layer is meant to be used for the
4141
CDS modelling feature toggles of the form `/fts/<feature-name>`. For details see
@@ -54,10 +54,17 @@ JS object that maps feature toggle keys to their respective configurations.
5454
| | `featureToggles.configFiles` | `options.configFiles` |
5555
| runtime | `featureToggles.config` | `options.config` |
5656

57-
This approach allows you to override configurations at various levels. To make the actual runtime configuration clear,
58-
you can use the `/rest/feature/state`, or `/rest/feature/redisRead` endpoints, or their underlying library counterpart
57+
This approach allows you to override toggle configurations at each level. For a given toggle, the _last occurrence_ of
58+
its configuration will override all previous occurrences. To make the actual configuration clear, you can use
59+
the `/rest/feature/state`, or `/rest/feature/redisRead` endpoints, or their underlying library counterpart
5960
`toggles.getFeaturesInfos()`.
6061

62+
{: .info }
63+
// TODO
64+
The toggle configurations in different layers can will be mixed together
65+
The override of a toggle configuration is never partial. In other words, you need to define all intended properties,
66+
for example _validations_, for each occurrence.
67+
6168
## Single Key Approach
6269

6370
| ![](concepts-single-key.png) |

0 commit comments

Comments
 (0)