|
-
March 26th, 2009, 03:09 PM
#1
Is It Crucial for a Developer to Use Doxygen when doing Projects in a Company?
I do not have experience in working with a group. However, i love to comment my code in a way that other developers can understand it, but i do not use such application, Doxygen. All my comments are inside the source code. Is there something wrong with this? or I have to use Doxygen? If apply for a job will they consider whether i used Doxygen or not?
Assuming the code is open source, i do not care who reads it...
What i believe: The rule of thumb is to make sure the reviewer should decipher it. Make sure you are writing code comments based onn "why-is-this?" rather than "what-it-is?".The comment should be precise. Fix me if i'm wrong
-
March 26th, 2009, 03:51 PM
#2
Re: Is It Crucial for a Developer to Use Doxygen when doing Projects in a Company?
The point of Doxygen is to generate documentation in a form that is easier to read when someone wants to find out the relevant interfaces provided by your code. To that end, you would mark out your functions, classes, namespaces, etc with special comments so that relevant markup can be generated. It is not a substitute for appropriate comments deep inside the source code.
-
March 27th, 2009, 02:41 AM
#3
Re: Is It Crucial for a Developer to Use Doxygen when doing Projects in a Company?
It is not crucial, but it can helps others, so I'd say is a sign of coder's maturity.
- Make it run.
- Make it right.
- Make it fast.
Don't hesitate to rate my post. 
-
March 27th, 2009, 06:06 AM
#4
Re: Is It Crucial for a Developer to Use Doxygen when doing Projects in a Company?
Posting Permissions
- You may not post new threads
- You may not post replies
- You may not post attachments
- You may not edit your posts
-
Forum Rules
|
Click Here to Expand Forum to Full Width
|