commit 284c6ca0e5287f8bf67bf53d82a787d0ceafd227 Author: teor <teor@torproject.org> Date: Sun Jun 23 16:48:51 2019 +1000 dir-list: explain semantic versioning in the Format Versions section It's better to explain before we start talking about versions. Cleanup after 30949. --- dir-list-spec.txt | 22 +++++++++++++--------- 1 file changed, 13 insertions(+), 9 deletions(-) diff --git a/dir-list-spec.txt b/dir-list-spec.txt index 1072904..9afef93 100644 --- a/dir-list-spec.txt +++ b/dir-list-spec.txt @@ -63,6 +63,16 @@ 1.3. Format Versions + The directory list format uses semantic versioning: https://semver.org + + In particular: + * major versions are used for incompatible changes, like + removing non-optional fields + * minor versions are used for compatible changes, like adding + fields + * patch versions are for bug fixes, like fixing an + incorrectly-formatted Summary item + 1.0.0 - The legacy fallback directory list format 2.0.0 - Adds name and extrainfo structured comments, and section separator @@ -151,16 +161,10 @@ [In second position, exactly once.] - The version of the directory list format. version_number uses - semantic versioning: https://semver.org + The version of the directory list format. - In particular: - * major versions are used for incompatible changes, like - removing non-optional fields - * minor versions are used for compatible changes, like adding - fields - * patch versions are for bug fixes, like fixing an - incorrectly-formatted Summary item + version_number is a semantic version, see the "Format Versions" + section for details. Version 1.0.0 represents the undocumented, legacy fallback list format(s). Version 2.0.0 and later are documented by this