I don't care. When I read my codes I understand them, even those I
wrote 10 years ago, I can't explain why but I never forget one of my
code, I know it's rare.
Read and modify others code is a concept which leads to bugs, you
can't say I'm wrong.
You want to change something. You clear his function and you rewrite
it, but you have to know what are is in and his out, so a great API
reference.
Welcome to the real world.
Forget the concept that others will read your code. If they do that
it's because your code is stinky, if it was good they don't need to
have a look. It's like try something and thinking since the beginning
that we are going to fail.
No.
I can only assume that you have taken part in even a medium-sized software
project, or a project with other people involved, or a long-term project.
In many situations software needs to be changed because of changing
requirements. That doesn't mean it was written wrongly the first time, it means
that when it was first written, you didn't know what you would need in 5 or 10
years time.
Look at Microsoft Windows. Windows 3.1 didn't provide any support for 3d
graphics cards, because they didn't exist yet. Windows Vista has features that
allow windows to fly all over the place, all made possible by 3d cards.
When I started using the internet, HTML 3.2 was the standard web language. Then
a new version, HTML 4.0, came out. Browsers had to be rewritten to use the new
language, or they would be able to browse the web. CSS was invented. Browsers
had to be rewritten to read stylesheets. The .png file format came out. Browsers
had to be rewritten to display them.
Do you really think Mozilla Firefox, or Microsoft Internet Explorer, could exist
if they had only one developer for their whole lifetime? If not, how could they
be written in such a way that noone ever has to read or modify someone else's
code? What if someone leaves the project?
(When I was 4 years old, I knew everything. As I get older and learn more I seem
to know less and less...)