minaa-chan

5 ms·

1. 1.▲
   by minaa-chan 7y ago

   So they should be updated the same as any other documentation. They're there to help. They don't need to be 100% infallible to be useful.
2. 2.▲
   by minaa-chan 7y ago

   That other mechanism is comments.
3. 3.▲
   by minaa-chan 7y ago

   I disagree. The code is the best place to comment the why. Regardless of what is documented or what is written up on jira or w/e, the code is what is true. Commenting the purpose of the code and maybe a link to some documentation allow
4. 4.▲
   by minaa-chan 7y ago

   That just makes two things that need to be commented doesn't it? When I read code I care about what the code is supposed to do and why it's supposed to do that. There is code that passes the current tests and is logically sound bu
5. 5.▲
   by minaa-chan 7y ago

   I don't. I do "good" things because that's the way I was raised. I actually dislike getting thanked or anything that draws attention to the "good" thing I did because it seems so needless. Occasionally I'l