Click here to Skip to main content
15,397,981 members

Welcome to the Lounge

   

For discussing anything related to a software developer's life but is not for programming questions. Got a programming question?

The Lounge is rated Safe For Work. If you're about to post something inappropriate for a shared office environment, then don't post it. No ads, no abuse, and no programming questions. Trolling, (political, climate, religious or whatever) will result in your account being removed.

 
RantDoxygen is not documentation Pin
den2k887-Jul-21 1:31
professionalden2k887-Jul-21 1:31 
GeneralRe: Doxygen is not documentation Pin
OriginalGriff7-Jul-21 1:33
mveOriginalGriff7-Jul-21 1:33 
GeneralRe: Doxygen is not documentation Pin
CPallini7-Jul-21 1:38
mveCPallini7-Jul-21 1:38 
GeneralRe: Doxygen is not documentation Pin
Greg Utas7-Jul-21 1:39
mveGreg Utas7-Jul-21 1:39 
GeneralRe: Doxygen is not documentation Pin
honey the codewitch7-Jul-21 2:35
mvahoney the codewitch7-Jul-21 2:35 
GeneralRe: Doxygen is not documentation Pin
den2k887-Jul-21 3:34
professionalden2k887-Jul-21 3:34 
GeneralRe: Doxygen is not documentation Pin
honey the codewitch7-Jul-21 3:35
mvahoney the codewitch7-Jul-21 3:35 
GeneralRe: Doxygen is not documentation Pin
jschell7-Jul-21 7:38
Memberjschell7-Jul-21 7:38 
If all you do is write simple methods then of course what you state is true.

But often methods fulfill complex needs that are not clear from the code itself. And comments are necessary to explain what need the code is fulfilling. A maintenance programmer should not be required to understand and be familiar with the entire application just so they can make a change in one method.

And that is an ideal world. Methods, especially in legacy code, often grow due to convenience and work load rather than because it was optimal. And with multiple requirements being met that way it becomes very difficult for maintenance programmers to make required changes without impacting the application in unexpected ways.
GeneralRe: Doxygen is not documentation Pin
honey the codewitch7-Jul-21 7:46
mvahoney the codewitch7-Jul-21 7:46 
GeneralRe: Doxygen is not documentation Pin
Stefan_Lang10-Jul-21 22:38
mveStefan_Lang10-Jul-21 22:38 
GeneralThis will get you... Pin
etkid848-Jul-21 3:53
Memberetkid848-Jul-21 3:53 
GeneralRe: Doxygen is not documentation Pin
PaltryProgrammer8-Jul-21 5:15
MemberPaltryProgrammer8-Jul-21 5:15 
GeneralRe: Doxygen is not documentation Pin
#realJSOP7-Jul-21 9:09
mva#realJSOP7-Jul-21 9:09 
Generalre: "We don't use Doxygen Pin
etkid848-Jul-21 3:55
Memberetkid848-Jul-21 3:55 
GeneralRe: re: "We don't use Doxygen Pin
#realJSOP8-Jul-21 23:09
mva#realJSOP8-Jul-21 23:09 
GeneralRe: Doxygen is not documentation Pin
dandy728-Jul-21 4:22
Memberdandy728-Jul-21 4:22 
GeneralRe: Doxygen is not documentation Pin
Marc Clifton7-Jul-21 3:22
mvaMarc Clifton7-Jul-21 3:22 
GeneralRe: Doxygen is not documentation Pin
hpcoder211-Jul-21 0:00
Memberhpcoder211-Jul-21 0:00 
GeneralRe: Doxygen is not documentation Pin
honey the codewitch11-Jul-21 2:34
mvahoney the codewitch11-Jul-21 2:34 
GeneralRe: Doxygen is not documentation Pin
Gary R. Wheeler7-Jul-21 12:36
MemberGary R. Wheeler7-Jul-21 12:36 
GeneralRe: Doxygen is not documentation Pin
RickZeeland7-Jul-21 1:44
mveRickZeeland7-Jul-21 1:44 
GeneralRe: Doxygen is not documentation Pin
honey the codewitch7-Jul-21 2:34
mvahoney the codewitch7-Jul-21 2:34 
GeneralRe: Doxygen is not documentation Pin
jsc427-Jul-21 3:28
professionaljsc427-Jul-21 3:28 
GeneralRe: Doxygen is not documentation Pin
  Forogar  7-Jul-21 4:33
professional  Forogar  7-Jul-21 4:33 
GeneralRe: Doxygen is not documentation Pin
PIEBALDconsult7-Jul-21 3:09
professionalPIEBALDconsult7-Jul-21 3:09 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.


Straw Poll

Do you expect users to read the instructions when using your apps?
  Results   349 votes