diff --git a/docs/schema.md b/docs/schema.md index 705a59e..0274cb3 100644 --- a/docs/schema.md +++ b/docs/schema.md @@ -830,8 +830,8 @@ Only **a single type** (either `introduced`, `fixed`, `last_affected`, `limit`) is allowed in each event object. For instance, `{"introduced": "1.0.0", "fixed": "1.0.2"}` is **invalid**. -Entries in the `events` array can contain either `last_affected` or `fixed` -events, but not both. It's **strongly recommended** to use `fixed` instead of +An events array can have entries containing either "last_affected" or "fixed" events, +but not both. It's **strongly recommended** to use `fixed` instead of `last_affected` where possible, as it precisely identifies the version which contains the fix. `last_affected` should be thought of as the hard ceiling of the vulnerability _at the time of publication_ in the absence of a fixed version.