Re: Google "Season of Docs"
- Date: Sun, 31 Mar 2019 12:11:38 +0530
- From: Kapil Jain <jkapil.cs@xxxxxxxxx>
- Subject: 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 ?