• 3 Posts
  • 2.12K Comments
Joined 2 years ago
cake
Cake day: June 12th, 2023

help-circle


  • If a function has 300 lines without a lot of supporting documentation then I doubt that it is “clear, readable and concise” anyway.

    Code - not function. Files often have multiple functions in them. If you can’t read and understand code - I don’t want you on my team.

    I have never found it hard at all to skip past comments that are not relevant because my code editor helpfully colors them differently from the rest of the code, making it easy. Does your editor not do the same?

    If it’s something people will simply skip over then it’s not useful. Don’t pollute code with tons of unnecessary comments that you think will be useful for some “perceived future”. They just add to your maintenance work.

    Write your code to be understandable and document the architecture/design separately.

    It depends on what you are doing. If you are implementing relatively simple logic like a REST API handler, then it is probably overkill. If you are implementing a relatively advanced algorithm, then having a running narrative of what is going can be extremely helpful.

    Agree - most code is pretty straight forward. Save the comments for where it’s needed.



  • You want to turn my 300 lines of clear, readable and concise logic into 1,000 lines of English paragraphs that break up the functions of my code into yet smaller pieces of code devoid of context? Now I have to dig through that book, ignoring all the shit I’ve read hundreds of times because it doesn’t compile into anything, just to debug an off-by-1 error in a loop buried in a paragraph explaining the original developers diatribe on why we’re looping over that range? Fuck. No.

    This is the sort of academic crap that sounds good but in practice is just terrible for anything other than small projects that are intended specifically to teach.


  • This is something I’ve said for a very long time. Everytime some RAD or “low code” tool claims that it will make developers obsolete because “you won’t need to write code”! I know that I’m going to need to help some BA use that tool and that there will be a tiny little box hidden in that tool somewhere which let’s me write code to work around its limitations.

    LLMs are useful to a developer as a cordless drill is to an engineer.

    Software development is about understanding logic, data structures, and how to solve business problems with computers. A language is simply what we use to do that.