doc: clarify valid array
@@ -24,7 +24,7 @@ an array or not.
## Decision
Store length in metadata `array` of key, or keep metadata `array` empty if empty array.
-Only children that have `#` syntax are allowed.
+Only children that have `#` syntax are allowed in a valid array.
The index start with `#0`.
Both `keyAddName("#12")` or `keyAddBaseName("#_12")` is allowed to add the 13th index.
@@ -80,12 +80,12 @@ user:/myarray/#0
system:/myarray # <- not found in cascading lookup, as user:/myarray exists
```
-Guarantees we want from the spec plugin:
+The `spec` plugin should check if it is a valid array, i.e.:
-- that the parent key always contain `array`.
-- that the correct length is in `array`
-- that the array only contains `#` children
-- that the children are numbered from 0 to n, without holes
+- that the parent key always contain the metadata `array`,
+- that the correct length is in `array`,
+- that the array only contains `#` children, and
+- that the children are numbered from `#0` to `#n`, without holes.
## Rationale
