I find Doxygen better for development documentation since it is embedded in the code. With programmers, out of sight is out of mind. Still there's only about a 30% chance the documentation will be updated when the code is changed.
Tabs. Programmers can set the tab stop in their editors to how many spaces they prefer to see. Code does not get weird indentation because different programmers use different number of spaces. And the level of indentation is clear.
Authored Comments
I find Doxygen better for development documentation since it is embedded in the code. With programmers, out of sight is out of mind. Still there's only about a 30% chance the documentation will be updated when the code is changed.
Tabs. Programmers can set the tab stop in their editors to how many spaces they prefer to see. Code does not get weird indentation because different programmers use different number of spaces. And the level of indentation is clear.