diff --git a/GOVERNANCE.md b/GOVERNANCE.md index e8338c9..8ff939d 100644 --- a/GOVERNANCE.md +++ b/GOVERNANCE.md @@ -8,7 +8,7 @@ This document governs the specification in this repository and the implementatio ## Who decides -The maintainers in [MAINTAINERS.md](MAINTAINERS.md). Decisions are made in the open, in issues and pull requests, and a decision that is not written there did not happen. Where maintainers disagree, the specification lead decides and records the reasoning in the issue. +The maintainers in [MAINTAINERS.md](MAINTAINERS.md). Decisions are made in the open, in issues and pull requests, and a decision that is not written there did not happen. Where maintainers disagree, the maintainer holding the specification area in [MAINTAINERS.md](MAINTAINERS.md) decides and records the reasoning in the issue. This is the honest description of a three-person project, not an aspiration. A steering committee including the projects that build on OO-LD is planned; until it exists, saying that it exists would be worse than admitting it does not. diff --git a/docs/contributing.md b/docs/contributing.md index f4568b7..e36c802 100644 --- a/docs/contributing.md +++ b/docs/contributing.md @@ -17,7 +17,7 @@ Run `make spec` after touching the specification, and `make check` before opening a pull request. `make check` is what CI runs. -Edit through a branch and a pull request. Nothing is pushed to `main` directly. +Edit through a branch and a pull request. The one exception is the release commit below, which is made on `main` because the tag has to point at it. ## Editing the specification diff --git a/docs/migration/from-legacy-osw.md b/docs/migration/from-legacy-osw.md index db18924..4d4691d 100644 --- a/docs/migration/from-legacy-osw.md +++ b/docs/migration/from-legacy-osw.md @@ -193,7 +193,7 @@ What changed: per-property boolean `x-oold-ui-default-property: true` (here on `description`) makes it **overridable** - a derived schema resets it to `false` under most-derived-wins resolution, without restating the whole list. The reverse-property form - `x-oold-reverse-default-properties` (also a root array, same limitation) migrates the same way. + `x-oold-reverse-default-properties` (also a root array, same limitation) was withdrawn in 1.0.0-rc.4 and has no replacement: nothing rejects it, and nothing reads it. - `options.conditional_visible` / `modes` on `query_label` have no OO-LD equivalent yet (they drove OSL query forms); record them and drop them, do not invent keywords (see Pitfalls).