On Wed, Oct 7, 2015 at 7:58 PM, Carsten Haitzler <[email protected]> wrote: > On Wed, 07 Oct 2015 18:07:50 +0000 Mike Blumenkrantz > <[email protected]> said: >> On Wed, Oct 7, 2015 at 1:58 PM Davide Andreoli <[email protected]> >> wrote: >> > 2015-10-07 4:52 GMT+02:00 Jean-Philippe ANDRÉ <[email protected]>: >> > > jpeg pushed a commit to branch master. >> > > >> > http://git.enlightenment.org/core/efl.git/commit/?id=12f9fea2a4d4d641a09fd6563a83b925d62e4868 >> > > >> > > commit 12f9fea2a4d4d641a09fd6563a83b925d62e4868 >> > > Author: Jean-Philippe Andre <[email protected]> >> > > Date: Fri Oct 2 18:14:25 2015 +0900 >> > > >> > > EDC Doc: Some fixes >> > > >> > > We need to move this doc to the wiki and complete it :) >> > > >> > >> > Moving the edcref to the wiki means that people cannot have it offline, and >> > I'm quite sure no devs will update the wiki after a change in the code. >> > So I'm quite against this idea >> > >> >> While I am not disagreeing that edc documentation could use improvements, I >> agree with keeping it in the source. We are not good at >> maintaining/updating in-source documentation, but we are even worse at >> anything not directly in the source tree. > > but then only "we" can edit docs. no one else can help or pitch in. the wiki > allows for discussions and editing by a far wider audience. it also happens to > be in git. :)
I may be on a loop on this, but I don't see reference documentation being written by anyone but dev. Look at the activity of our current wiki. People can easily contribute tutorial and guide, but it is still only developers involved in EFL who do so for a very large majority of the content (Above 90% of the content easily). I would love to be wrong here, but I think it is still more productive to keep the documentation in front of the developers eyes or it will just never be up to date. -- Cedric BAIL ------------------------------------------------------------------------------ _______________________________________________ enlightenment-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
