• 161 Posts
  • 1.4K Comments
Joined 1 year ago
cake
Cake day: June 9th, 2023

help-circle
  • A big part of it is manuals are increasingly non-present or unhelpful. Though, home appliances normally have useful ones still and I have used them on several occasional when doing repairs.

    more and more projects are moving all documentation to discord

    This is absolutely a trend that needs to stop. It is worse for individuals as info is completely unsearchable; and it is worse for the Discord admins and helpers as they have to answer the same questions over and over as nobody can find previous answers to the same question. A classic forum is optimal for public support.


















  • Code should absolutely speak for itself. But the occasional comment is still good to explain the ‘why’ of the code when the why isn’t very obvious, often due to a niche requirement. Also any time you have to break out a hack, that needs comments up the ass, what was the bug, what URL did you find the fix at, why does this hack work, etc etc. It’s very satisfying to go back and remove those hacks after they are no longer needed, often because the underlying technology fixed the bug that had to be hacked around.