googlefonts/gf-docs

Spec: Font versioning

Closed this issue · 1 comments

wayne-shih commented

I'm tying to understand the font versioning outlined here https://github.com/googlefonts/gf-docs/tree/main/Spec#font-versioning

Font versioning

Versioning is based on semver, apart from we use MAJOR.SIGNIFICANTMINORPATCH, instead of MAJOR.MINOR.PATCH.

Examples:

If a breaking change is made e.g converting a static font family to a variable font family, the MAJOR must be incremented by 1 and the others reset e.g

Current 1.230, new 2.000

If a new character set is inserted, SIGNIFICANT should be incremented e.g:

Current 1.230, new 1.330

If a few new glyphs are added, MINOR should be incremented e.g:

Current 1.230, new 1.240

If a name table record is updated such as the copyright string, PATCH should be incremented e.g:

Current 1.230, new 1.231

For the second example, where the significant is incremented, but looks like the minor remained the same. Should that stay the same or should it reset?

ie. is it a typo and should it be changed to...

   If a new character set is inserted, SIGNIFICANT should be incremented e.g:
 
-  Current 1.230, new 1.330
+  Current 1.230, new 1.300
m4rc1e commented

Correct.

  • 👍1