John Ralls writes:
> Some programmers, often less-experienced ones, will comment code
> liberally to explain what they’re doing. More experienced programmers
> often find this irritating because they’re fluent enough in the
> programming language that they can understand the code without the
> co
Hi,
Matt Graham writes:
> G’day all!
>
>
> Whilst there is lot of enthusiasm about documentation flowing around,
> I thought I’d ask a general question regarding the last type of
> documentation not previously mentioned: The doxygen generated
> documentation about how the code works (can I call
> On Aug 31, 2015, at 3:44 AM, Matt Graham wrote:
>
> G’day all!
>
>
> Whilst there is lot of enthusiasm about documentation flowing around, I
> thought I’d ask a general question regarding the last type of documentation
> not previously mentioned: The doxygen generated documentation about
G’day all!
Whilst there is lot of enthusiasm about documentation flowing around, I
thought I’d ask a general question regarding the last type of documentation not
previously mentioned: The doxygen generated documentation about how the code
works (can I call it the API?).
I’ve been taking my
On Sat, 29 Aug 2015 16:52:48 +0200
Geert Janssens wrote:
> On Saturday 29 August 2015 06:38:53 John Ralls wrote:
> > > On Aug 29, 2015, at 5:43 AM, Mike Evans
> > > wrote:
> > >
> > > Another random thought then.
> > >
> > > I use asciidoc for pretty much all the docs I write, not much
> > > a
