• 0 Posts
  • 58 Comments
Joined 1 year ago
cake
Cake day: June 11th, 2023

help-circle
  • I’m a new developer. Is that referring to page 123 of the in-house documentation? Version 12.3 of the code? I have no clue.

    You’d have to call it something like calculatePersonalIncomeTaxPerTaxCodeSection1_2_3, but I get exhausted just looking at that. There comes a point where the cognitive work of reading crazy long camel case names is more trouble than it’s worth.

    An explanation of what specification a function was written to implement is a perfectly appropriate comment. Could be improved by a direct link where possible. But it’s worth noting what that comment isn’t doing - specifying any implementation details. For that, I really can just read the code.







  • I’ve seen this complaint a lot with some of the newer shows, but it doesn’t really resonate with me. A good central character ought to be able to carry a show, and I don’t hold Trek as being inherently different in that regard. In fact, I think the original series would have been an example of a show like that if Spock’s popularity hadn’t been taken into consideration by later writers. Even then, I believe it would have a pretty low “pass” rate compared to all the '90s series.

    (Incidentally, since Burnham wasn’t Captain until season 4, Discovery passes on a technicality for most of its run).