Web lists-archives.com

Re: Google "Season of Docs"




On Sat, Mar 30, 2019 at 10:48 PM Philip Oakley <philipoakley@xxxxxxx> wrote:
>
> * Developers rarely want to write documentation (it's too obvious to them)
> -- Our code base has become larger than the average brain-full, maybe
> that (developer education) also could also benefit from some further
> structural documentation.

by developer documentation you mean, a doc explaining what each function does ?
agreed, such developer education will help a lot.
i am currently trying to do that for `pretty.c`

> -- if stack-overflow is the go-to source for 'real' users, why not mine
> that source.

this point is unclear, please elaborate.
I mean stack overflow is searchable already, what kind of mining are
we talking about ?