The process of commenting and improving an already written program?

Please allow my introduction to correctly define the scope of my question:

I am still very new to the programming world. It all started for me when I had an idea for software, but no programming experience. I ended up going outsourcing to get a program, and after almost a year we live and work.

This special program is written using php and is 100% web based. We use a lot of ajax, jQuery, etc.

Now, a year later, I studied and studied wherever I can (studies a lot here !!!). I mainly focus on Java now, to make up Objective-C and iPhone fun (probably like 99% of all other newbie programmers).

I really learned a lot, and one of the biggest things I learn is proper commenting and scalability.

Now I see that this work, which we just finished, is sorely lacking in both areas. I want to add and use this program, and not only I do not have much experience, but I see that it is very difficult for me to even get an idea of ​​the functions without these comments ...

So my question is: what is the best way to start collecting fragments of this program? A complete rewrite is out of the question, and I do not think it is necessary.

I am sure this is not the first time a novice programmer, software developer has been along this path ... what are others doing here?

, "" , ?

( , ), - , ?

! Joel

+3
5
+5

, , , - .

-, , " ", . . .

, , Clean Code , , , . . , , , . , . , . Clean Code .

, , . , .

, , , . , , , ...

:

  • . , . -OR -
  • , . -OR -
  • .

.

, : ? , , .

, Refactoring. - . , . .

, "" , ?

, . , . .

+2

, , , :

, "" , ?

, . 10 , , - , . , , , .

, : ? , , .

, "" , , , - , , . , , , , , , -.

, , , - .

, , , YAGNI. , , . - , ? , , .

+1

, "" , ?

:)

, IIABTFI. , .

, .

.

0

: , , ? , , , 101 , .

, , , , , , . , , , , , , , .

, , , -, . , , , , , , , .

0

Source: https://habr.com/ru/post/1733417/


All Articles