3 ms·
The Protobuf documentation made me cringe. Every character of its "personality" adds a cognitive burden for the reader and a maintenance burden for anyone who h
by willseth 5y ago
The Protobuf documentation made me cringe. Every character of its "personality" adds a cognitive burden for the reader and a maintenance burden for anyone who has to update it. If a developer wants to be cute with the same brevity and clarity that the comments would have otherwise, fine. Otherwise it's self-indulgent performative trash that should be rejected in review.
- SV_BubbleTime 5y agoAbsolutely. That was not a good example for me. > self-indulgent performative trash A little harsher than I would have used; but now that you say it. >that should be rejected in review. Without question. I would have absolutely denied that until it was trimmed to at most 10% of what was there.