/ go Public
go/doc: reconsider comment rewrites of
Feedback is required from experts, contributors, and/or the community before a change can be made.
In ae3d890 as part of addressing #51082, a change was made to go/doc that rewrite all
”. This makes semantic changes to comments where
'is used as a prime and
''is used as double prime, common in mathematical code.
This was raised in #51082 (comment) but essentially disregarded. A work around was suggested,
However on investigation with relevant fonts (the font here and the font used by pkg.go.dev) at 100%, U+2033 DOUBLE PRIME is barely distinguishable from U+2032 PRIME and worse, also barely distinguishable from other commonly used marks in the same position such as '*' (Comparison: f′ f″ f* ).
The change has made it harder to read these comments, harder to write them in a way that doesn't get mutated and easier for incorrectly formatted comments to be committed (f'' getting mutated to f” which is essentially indistinguishable from f″ at normal font sizes).
The text was updated successfully, but these errors were encountered: