Tekstit

Näytetään blogitekstit, joiden ajankohta on maaliskuu, 2025.

To comment or not to comment

  During our holiday week, we had a task to read a chapter of a book and summarize it. I chose a book called “Code complete ”. As indicated in the title, the book focuses on coding . I t focused precisely on the man y different stag es of coding . The book was quite long, 855 pages, so if you were to read the whole book, you would know all about coding and software development. Of course I did n ’t have the time to read the whole book, but I chose a single chapter that interested me. The chapter was called “to comment or not to comme nt ”. The chapter was presented as a dialogue, where ph ilosophers discusse d whether or n ot code comments are useful.     The arguments against it were that comments make the code harder to read due to the additional text. A good code should also be self-documenting and not require additional explanation . Others argued that comments make the code easier to read, especially if it’s someone else’s code. I totally agree ...