Re: GNUe and beginners

Reinhard Mueller <[email protected]> Mon, 23 Oct 2006 14:27:23 +0200
Newsgroups gmane.comp.gnu.enterprise.general
Organization GNU Enterprise
Message-ID <1161606443.5382.40.camel@dublin>
Am Montag, den 23.10.2006, 14:31 +0300 schrieb Adrian Maier:
> > Personally, I have given up hope to ever get any help with
> > documentation, no matter in which format. I have learned (the hard way)
> > that as a developer, you must write your docs yourself.
> 
> Well, in order to get help the first step is to have enough
> non-developers  that
> have sufficient knowledge so that they can write documentation.

Yes. Actually I even think it is *right* that the developers write the
docs, because docs should be accurate, complete, and up to date, and
that's something that people more or less outside the project usually
can't achieve.

> > "Core documentation" is documentation that is of no interest to the
> > user, but is only targeted at developers of the tools themselves. It
> > makes sense to keep them separate, IMHO.
> 
> Hmmm...  The API reference is of interest only for the gnue
> developers ?

Yes, and possibly for some deveopers that want to reuse parts of GNUe
code for their own project (gnue-common is a candidate for being reused
in non-gnue projects)

> What do you mean by "user" ?  final-users, or
> developers-that-build-applications-with-gnue ?

Both.

Thanks,
-- 
Reinhard Mueller
GNU Enterprise project (http://www.gnuenterprise.org)

_______________________________________________
Gnue mailing list
[email protected]
http://lists.gnu.org/mailman/listinfo/gnue
signature.asc (application/pgp-signature, 309 B)
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2.2 (GNU/Linux)

iQCVAwUARTy1Jypv03KHfKbjAQKNGAP+MnP94+wUJiV0fm7Gxp0i3Q8f7EeGc1zl
jJw2mEUdmhzOAsaHs439yxzw3mwcTqfd6cY5UvWGZI8MsCMz6GVm2JODTOfKg593
Bj+p/rluCWqinuA4Npox4TUun61YEIEiosvJWLaAGcoUrgvcH0+UhmZr8Rm82/Dp
vodQGS8JVgA=
=tqmI
-----END PGP SIGNATURE-----