[Mono-docs-list] HTML docs

[Rodolfo Campero]

El lun, 24-05-2004 a las 15:43, Joshua Tauberer escribi=F3:
> Miguel de Icaza wrote:
> > It means that by using HTML we are not using our own tools on a daily
> > basis (like Gtk#, Monodoc, Mono's JIT) ;-)
>=20
> Shouldn't we also test the documentation tools?  :)
>=20
> > A chapter on `Documentation Tools' for the Monkeyguide is the right
> > thing to do (it must be XHTML)
>=20
> In the works.
>=20
> Would it be okay if I hacked up Monodoc so that it can be use to edit=20
> documentation files stored locally?  If people are going to use the new=20
> tools to document their own assemblies (like me), it would be helpful to=20
> edit the documentation with Monodoc's editing feature.
>=20
> What I'd like to do is add a command line option --local-edit=20
> [path-to-docs], which adds into the tree a HelpSource that accesses the=20
> XML files on disk.

Going further with your idea, it would be nice to turn Monodoc into a
collaborative documentation editor. This way, third party project admins
could be able to add information about the location of its central
documentation repository inside their monodoc files, and Monodoc would
know where to send the patches.

I imagine a "pluggable" mechanism for collaborative editing management,
so changes can be sent to different targets: local file, web service,
cvs repository, email (for projects without Internet hosting resources),
etc.

Do you think this make sense and is feasible?