Debian Codegraph @

googlefonts-qa/notes/QA-notes.md

raw
1 # QA Notes – checking & polishing Fira Code for Google Fonts
2
3 - [x] autohint static TTFs
4 - [ ] check extrapolated outlines for issues
5
6 ## Checks to resolve
7
8
9
10 ======================================================================================
11
12 ## Waiting on others
13
14 <details>
15 <summary>πŸ”₯ <b>FAIL:</b> Copyright notices match canonical pattern in fonts</summary>
16
17 * [com.google.fonts/check/font_copyright](https://github.com/googlefonts/fontbakery/search?q=com.google.fonts/check/font_copyright)
18 * πŸ”₯ **FAIL** Name Table entry: Copyright notices should match a pattern similar to: 'Copyright 2017 The Familyname Project Authors (git url)'
19 But instead we have got: 'Copyright 2012-2015 The Mozilla Foundation, Telefonica S.A., and Nikita Prokopov (https://github.com/tonsky/FiraCode)'
20
21 </details>
22
23 - additionally, it's unclear how the original copyright on Fira Mono & Fira Code should best be integrated to credit all designers involved
24
25 - [x] file issue on fontbakery (https://github.com/googlefonts/fontbakery/issues/2419)
26 - [x] confirm that current approach is fine (https://github.com/google/fonts/issues/1460#issuecomment-476713822) (seems okay, based on Hangouts discussion)
27
28 ----------------------------
29
30 <details>
31 <summary><b>[119] FiraCode-Light.ttf</b></summary>
32 <details>
33 <summary>πŸ”₯ <b>FAIL:</b> Checking file is named canonically.</summary>
34
35 * [com.google.fonts/check/canonical_filename](https://github.com/googlefonts/fontbakery/search?q=com.google.fonts/check/canonical_filename)
36 * πŸ”₯ **FAIL** This is a variable font, but it is using a naming scheme typical of a static font.
37 * πŸ”₯ **FAIL** Please change the font filename to use one of the following valid suffixes for variable fonts: VF, Italic-VF, Roman-VF
38
39 </details>
40
41 - [x] ask if/when this is changing (via hangouts) – Marc: "We’ll batch the vfs once they’ve implemented it"
42
43 ----------------------------
44
45 ======================================================================================
46
47 ## Edits and corrected FontBakery checks
48
49
50
51 <details>
52 <summary>⚠ <b>WARN:</b> Stricter unitsPerEm criteria for Google Fonts. </summary>
53
54 * [com.google.fonts/check/unitsperem_strict](https://github.com/googlefonts/fontbakery/search?q=com.google.fonts/check/unitsperem_strict)
55 * ⚠ **WARN** Even though unitsPerEm (1000) in this font is reasonable. It is strongly advised to consider changing it to 2000, since it will likely improve the quality of Variable Fonts by avoiding excessive rounding of coordinates on interpolations.
56
57 </details>
58
59 - [x] scale UPM to 2000
60
61 ----------------------------
62
63 <details>
64 <summary>πŸ”₯ <b>FAIL:</b> Are there non-ASCII characters in ASCII-only NAME table entries?</summary>
65
66 * [com.google.fonts/check/name/ascii_only_entries](https://github.com/googlefonts/fontbakery/search?q=com.google.fonts/check/name/ascii_only_entries)
67 * πŸ”₯ **FAIL** There are 1 strings containing non-ASCII characters in the ASCII-only NAME table entries.
68 * β„Ή **INFO** Bad string at [nameID 0, 'utf_16_be']: 'b'Copyright &#169; 2015 by Nikita Prokopov''
69
70 </details>
71
72 - [x] remove Β© symbol
73
74 ----------------------------
75
76 <details>
77 <summary><b>[31] Family checks</b></summary>
78 <details>
79 <summary>πŸ”₯ <b>FAIL:</b> METADATA.pb: According Google Fonts standards, families should have a Regular style.</summary>
80
81 * [com.google.fonts/check/metadata/has_regular](https://github.com/googlefonts/fontbakery/search?q=com.google.fonts/check/metadata/has_regular)
82 * πŸ”₯ **FAIL** This family lacks a Regular (style: normal and weight: 400) as required by Google Fonts standards.
83
84 </details>
85
86 - [x] this issue is already filed with fontbakery (https://github.com/googlefonts/fontbakery/issues/2378)
87
88 ----------------------------
89
90 <details>
91 <summary>πŸ”₯ <b>FAIL:</b> Checking OS/2 usWinAscent & usWinDescent.</summary>
92
93 * [com.google.fonts/check/family/win_ascent_and_descent](https://github.com/googlefonts/fontbakery/search?q=com.google.fonts/check/family/win_ascent_and_descent)
94 * πŸ”₯ **FAIL** OS/2.usWinAscent value should be equal or greater than 1050, but got 935 instead [code: ascent]
95 * πŸ”₯ **FAIL** OS/2.usWinDescent value should be equal or greater than 500, but got 265 instead [code: descent]
96
97 </details>
98
99 - [x] run script to correct vertical metrics, recheck
100 - [x] ~~add issue~~ issue exists to gf-docs to update vertical metrics to recommendation at https://github.com/googlefonts/fontbakery/issues/2164#issuecomment-436595886 (will track / manage separately)
101
102
103 ----------------------------
104
105 <details>
106 <summary>πŸ”₯ <b>FAIL:</b> Glyph names are all valid?</summary>
107
108 * [com.google.fonts/check/valid_glyphnames](https://github.com/googlefonts/fontbakery/search?q=com.google.fonts/check/valid_glyphnames)
109 * πŸ”₯ **FAIL** The following glyph names do not comply with naming conventions: ['numbersign_numbersign_numbersign.liga', 'numbersign_numbersign_numbersign_numbersign.liga', 'numbersign_underscore_parenleft.liga', 'backslash_backslash_backslash.rem', 'numbersign_numbersign_numbersign.liga.rem', 'numbersign_numbersign_numbersign_numbersign.liga.rem', 'semicolon_semicolon_semicolon.rem', 'quadrantUpperLeftAndLowerLeftAndLowerRight', 'quadrantUpperLeftAndUpperRightAndLowerLeft', 'quadrantUpperLeftAndUpperRightAndLowerRight', 'quadrantUpperRightAndLowerLeftAndLowerRight', 'whiteSquareWithUpperLeftQuadrant', 'whiteSquareWithLowerLeftQuadrant', 'whiteSquareWithLowerRightQuadrant', 'whiteSquareWithUpperRightQuadrant', 'asciitilde_asciitilde_greater.liga', 'ampersand_ampersand_ampersand.rem', 'asciitilde_asciitilde_asciitilde.rem'] A glyph name may be up to 31 characters in length, must be entirely comprised of characters from the following set: A-Z a-z 0-9 .(period) _(underscore). and must not start with a digit or period. There are a few exceptions such as the special character ".notdef". The glyph names "twocents", "a1", and "_" are all valid, while "2cents" and ".twocents" are not.
110
111 </details>
112
113 - [x] issue filed at https://github.com/tonsky/FiraCode/issues/730 – I'm guessing this won't cause any real issues on the web fonts.
114 - I'll leave these glyphs as they are for now, and let @tonsky handle it if it seems to be the cause of an actual user issue
115
116 ----------------------------
117
118 <details>
119 <summary>πŸ”₯ <b>FAIL:</b> Variable font weight coordinates must be multiples of 100.</summary>
120
121 * [com.google.fonts/check/varfont_weight_instances](https://github.com/googlefonts/fontbakery/search?q=com.google.fonts/check/varfont_weight_instances)
122 * πŸ”₯ **FAIL** Found an variable font instance with 'wght'=450.0. This should instead be a multiple of 100.
123
124 </details>
125
126 - (fontmake also started to fail, as "Retina" instance was given a custom param of `weightClass: 900`)
127
128 - [x] uncheck "Retina" instance as `is active` instance
129 - [x] file issue with FontBakery to ask Dave/Marc about this `450` weight "Retina" instance (https://github.com/googlefonts/fontbakery/issues/2420)-
130 - [x] change if you find a better approach to keep Retina without disrupting builds / Regular weight
131 - To set up the instance in GlyhpsApp such that it exports a font as expected: "Retina" gets a custom parameter of `weightClass: 450`, and a glyphs menu-weight of "Normal." Tested in axis-praxis, it seems to work well. All instances have a `weightClass` custom parameter.
132
133 ----------------------------
134
135 <details>
136 <summary>πŸ”₯ <b>FAIL:</b> Checking OS/2 usWeightClass.</summary>
137
138 * [com.google.fonts/check/usweightclass](https://github.com/googlefonts/fontbakery/search?q=com.google.fonts/check/usweightclass)
139 * πŸ”₯ **FAIL** OS/2 usWeightClass expected value for 'Light' is 300 but this font has 400.
140
141 </details>
142
143 - [ ] explore to find why this would be happening ...
144 - Encode Sans gets an OS/2 usWeightClass of `100`, matching its default instance.
145
146 **Solution**
147 - Custom Parameters of `Axis Location` needed to be set in source masters (https://github.com/googlei18n/fontmake/issues/540)
148
149 ----------------------------