Click here to Skip to main content
11,640,788 members (59,864 online)

Welcome to the Lounge

   

For lazing about and discussing anything in a software developer's life that takes your fancy except programming questions.

Technical discussions are encouraged, but click here to ask your programming question.

The Lounge is rated PG. If you're about to post something you wouldn't want your kid sister to read then don't post it. No flame wars, no abusive conduct, no programming questions and please don't post ads.
 
GeneralRe: Vegemite Cure to save the Great Barrier Reef Pin
jschell8-Oct-12 9:08
memberjschell8-Oct-12 9:08 
GeneralRe: Vegemite Cure to save the Great Barrier Reef Pin
lewax008-Oct-12 9:30
memberlewax008-Oct-12 9:30 
GeneralRe: Vegemite Cure to save the Great Barrier Reef Pin
JimmyRopes8-Oct-12 3:33
memberJimmyRopes8-Oct-12 3:33 
GeneralRe: Vegemite Cure to save the Great Barrier Reef Pin
Brady Kelly8-Oct-12 1:50
memberBrady Kelly8-Oct-12 1:50 
GeneralI think this could go further... Pin
Dalek Dave8-Oct-12 0:05
memberDalek Dave8-Oct-12 0:05 
GeneralRe: I think this could go further... Pin
harold aptroot8-Oct-12 0:31
memberharold aptroot8-Oct-12 0:31 
GeneralRe: I think this could go further... Pin
Sentenryu8-Oct-12 0:34
memberSentenryu8-Oct-12 0:34 
GeneralRe: I think this could go further... Pin
Dalek Dave8-Oct-12 0:43
memberDalek Dave8-Oct-12 0:43 
GeneralRe: I think this could go further... Pin
Sentenryu8-Oct-12 0:52
memberSentenryu8-Oct-12 0:52 
GeneralRe: I think this could go further... Pin
Mark Wallace8-Oct-12 1:40
memberMark Wallace8-Oct-12 1:40 
GeneralRe: I think this could go further... Pin
Mark Wallace8-Oct-12 1:26
memberMark Wallace8-Oct-12 1:26 
GeneralRe: I think this could go further... Pin
wizardzz8-Oct-12 4:21
memberwizardzz8-Oct-12 4:21 
GeneralRe: I think this could go further... Pin
ednrg8-Oct-12 8:16
memberednrg8-Oct-12 8:16 
GeneralDoxygen considered harmful Pin
YvesDaoust7-Oct-12 23:54
memberYvesDaoust7-Oct-12 23:54 
For the Nth time in my developer's career, I came across an API which was documented using Doxygen. (For the sake of mercy, I won't name it.)

As usual, all you are entitled to is a very terse introductory page, accompanied by the bloody, endless, uninformative Class Reference. As a bonus, you also get that wonderfully useless File List.

This way to document software drives me mad. It forces you to scan the whole API before you know if the functionality suits your needs, and gives you no hint on the philosophy of the stuff. This turns the discovery of otherwise valuable products into a painful guesswork and causes the learning curve to raise vertically.

I put most of the blame on Doxygen, because it gives programmers a false feeling that they did document their API, and that they did it in a "lush" way. I put the blame on Doxygen because of the poor presentation style it spreads and legitimizes, which favors form over content.
GeneralRe: Doxygen considered harmful Pin
Nagy Vilmos8-Oct-12 0:04
memberNagy Vilmos8-Oct-12 0:04 
GeneralRe: Doxygen considered harmful Pin
Espen Harlinn8-Oct-12 0:14
mvpEspen Harlinn8-Oct-12 0:14 
GeneralRe: Doxygen considered harmful Pin
YvesDaoust8-Oct-12 0:20
memberYvesDaoust8-Oct-12 0:20 
GeneralEhhrmm .... Pin
Espen Harlinn8-Oct-12 1:11
mvpEspen Harlinn8-Oct-12 1:11 
GeneralRe: Ehhrmm .... Pin
Mark Wallace8-Oct-12 1:35
memberMark Wallace8-Oct-12 1:35 
GeneralRe: Ehhrmm .... Pin
YvesDaoust8-Oct-12 1:49
memberYvesDaoust8-Oct-12 1:49 
GeneralRe: Ehhrmm .... Pin
Espen Harlinn8-Oct-12 1:54
mvpEspen Harlinn8-Oct-12 1:54 
GeneralRe: Ehhrmm .... Pin
Mark Wallace8-Oct-12 2:08
memberMark Wallace8-Oct-12 2:08 
GeneralRe: Ehhrmm .... Pin
Espen Harlinn8-Oct-12 2:19
mvpEspen Harlinn8-Oct-12 2:19 
GeneralRe: Ehhrmm .... Pin
YvesDaoust8-Oct-12 1:48
memberYvesDaoust8-Oct-12 1:48 
GeneralRe: Ehhrmm .... Pin
Espen Harlinn8-Oct-12 1:55
mvpEspen Harlinn8-Oct-12 1:55 
GeneralRe: Ehhrmm .... Pin
YvesDaoust8-Oct-12 1:59
memberYvesDaoust8-Oct-12 1:59 
GeneralRe: Ehhrmm .... Pin
Espen Harlinn8-Oct-12 2:22
mvpEspen Harlinn8-Oct-12 2:22 
GeneralRe: Doxygen considered harmful Pin
Chris Quinn8-Oct-12 0:15
memberChris Quinn8-Oct-12 0:15 
GeneralRe: Doxygen considered harmful Pin
YvesDaoust8-Oct-12 0:22
memberYvesDaoust8-Oct-12 0:22 
GeneralRe: Doxygen considered harmful Pin
Eddy Vluggen8-Oct-12 0:59
memberEddy Vluggen8-Oct-12 0:59 
GeneralRe: Doxygen considered harmful Pin
YvesDaoust8-Oct-12 1:46
memberYvesDaoust8-Oct-12 1:46 
GeneralRe: Doxygen considered harmful Pin
Mark Wallace8-Oct-12 1:32
memberMark Wallace8-Oct-12 1:32 
GeneralRe: Doxygen considered harmful Pin
YvesDaoust8-Oct-12 1:51
memberYvesDaoust8-Oct-12 1:51 
GeneralRe: Doxygen considered harmful Pin
Brady Kelly8-Oct-12 2:12
memberBrady Kelly8-Oct-12 2:12 
GeneralHTML Help considered harmful Pin
peterchen8-Oct-12 1:38
memberpeterchen8-Oct-12 1:38 
GeneralRe: HTML Help considered harmful Pin
YvesDaoust8-Oct-12 1:55
memberYvesDaoust8-Oct-12 1:55 
GeneralAOTD Pin
Nagy Vilmos7-Oct-12 23:04
memberNagy Vilmos7-Oct-12 23:04 
GeneralRe: AOTD Pin
Kenneth Haugland7-Oct-12 23:08
memberKenneth Haugland7-Oct-12 23:08 
GeneralRe: AOTD Pin
ChrisElston7-Oct-12 23:08
memberChrisElston7-Oct-12 23:08 
GeneralRe: AOTD Pin
Nagy Vilmos7-Oct-12 23:09
memberNagy Vilmos7-Oct-12 23:09 
GeneralRe: AOTD Pin
ChrisElston7-Oct-12 23:14
memberChrisElston7-Oct-12 23:14 
GeneralRe: AOTD Pin
Nagy Vilmos7-Oct-12 23:10
memberNagy Vilmos7-Oct-12 23:10 
GeneralRe: AOTD Pin
ChrisElston7-Oct-12 23:15
memberChrisElston7-Oct-12 23:15 
GeneralRe: AOTD Pin
TPFKAPB7-Oct-12 23:22
memberTPFKAPB7-Oct-12 23:22 
GeneralRe: AOTD Pin
Nagy Vilmos7-Oct-12 23:24
memberNagy Vilmos7-Oct-12 23:24 
GeneralRe: AOTD Pin
Dalek Dave7-Oct-12 23:27
memberDalek Dave7-Oct-12 23:27 
GeneralRe: AOTD Pin
Kenneth Haugland7-Oct-12 23:25
memberKenneth Haugland7-Oct-12 23:25 
GeneralRe: AOTD Pin
Nagy Vilmos7-Oct-12 23:29
memberNagy Vilmos7-Oct-12 23:29 
GeneralRe: AOTD Pin
Nagy Vilmos7-Oct-12 23:23
memberNagy Vilmos7-Oct-12 23:23 
GeneralRe: AOTD Pin
TPFKAPB7-Oct-12 23:11
memberTPFKAPB7-Oct-12 23:11 

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

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


Advertise | Privacy | Mobile
Web03 | 2.8.150731.1 | Last Updated 1 Aug 2015
Copyright © CodeProject, 1999-2015
All Rights Reserved. Terms of Service
Layout: fixed | fluid