3 ms·
This communicates an important idea, Well-written code is not only correct and efficient, but it is also readable, maintainable, and understandable to other pro
by lordwiz 3y ago
This communicates an important idea, Well-written code is not only correct and efficient, but it is also readable, maintainable, and understandable to other programmers.
This culture should be encouraged more to make other developer's life easier, The thing I do nowadays is that I would often switch perspectives now and then, When switching perspectives, if i become confused, i would work on making the code more meaningful.
Even if we are doing a solo project, if we come back to the code after a long while, the code should be greeting us with wide open hands rather than looking like an unexplored jungle.
- cratermoon 3y agoWhen I'm programming I try to keep in mind what my future self would need. I take notes when I'm programming, and put those notes into the repo if it's a personal project, or in a separate repo just for the project. Mostly those notes are of little value to anyone by myself, but having them around lets me condense my thoughts down to comments or documents useful for other team members. With a little work, I can turn my notes into a variety of other kinds of useful documentation: references, explanations, FAQs, runbooks, etc.