[Mono-list] Mono Documentation Project

Pablo Fischer pablo@pablo.com.mx
Tue, 09 Dec 2003 12:23:05 -0600


Ooops..

Sorry, maybe for next time :) I was just thinking around.

:)
Thanks anyway!

El lun, 08-12-2003 a las 11:24, Miguel de Icaza escribi=F3:
> Hello,
>=20
> > * A Client where the 'documentation' guys can Add/Delete/Modify
> > sections, subsectiosn, content in a easy way, for example if I like to
> > create documentation I just run the client, connect to the site and
> > communicdate via SOAP or XMLRPC and check the sections that exists or
> > create new sections (for example a gtkhtml-sharp section) and Add
> > content and th econtent will be send to the Webservice (that could be i=
n
> > phpxmlrpc, or pure ASP.NET).=20
>=20
> Unlike the Mono Class Library documentation where the stubs are already
> set in stone, and the markup language is a tiny subset, doing a general
> purpose HTML editor for the tutorial is not likely the solution to the
> problem.
>=20
> The problem with the handbook is a human problem: someone needs to read
> the whole text, make changes, edits, removals, clarifications, updates
> and this is a manual process.  Unlike the class library documentation
> where things are fairly well isolated and the framework is set, in this
> case you need someone to actively drive this process, and a tool is not
> the solution to the problem, the Monkeyguide problem has nothing to do
> with tools.
>=20
> Miguel.
>=20