[Mono-docs-list] Mono Documentation.

[Felix Faassen]

Hi Alejandro,

Great. It looks like there are a lot of people who want to contribute. Im
in the progress of posting my first toc written in Docbook.
I use the Borges framework which is used by the folks at mandrake.

The framework is very modulair. I also have definied the entity documents
and modules so when it's finished we could put it in a CVS and every
section has it's own xml file.
Sections can be added very easily.
However we have some problems with the make files I use, they don't work
on BSD we have to fix it someway.

When it's finished I'll post it here. May be some docbook experts
can check out?

I'll incorperate your additions also. The master toc is just a
start point.

I'll hope we soon can set up a CVS rep. for the XML docbook files so
everybody can start documenting on it in a structured way ;-)

Take Care,

Felix


Alejandro =?ISO-8859-1?Q?S=E1nchez?= Acosta wrote:

> Hi everybody!
>
> I am Alejandro Sánchez Acosta, and now I am making all the GTK# tutorial
samples side with the Cesar help and soon I'll can begin contributing
with the GNOME.NET tutorial.
>
> In the GTK# tutorial the work that we are making is porting all the
samples from the gtk+ tutorial to gtk# and then when we have finished
that we begin with the documentation part. Johanes has made some
documentation part that you can see in gnometutorial.
>
> Here in Mono Hispano, we have made a lot of documentation about Mono,
maybe some of the tutorials can be translated to english and have
covered some parts that proposed Felix in his fantastic index.
>
> Anyway it would be great that each one assign a part from the index that
Felix has made, that is excelent, and then step by step we begin working
in the tutorial.
>
> I want to colaborate with some parts from the tutorial, I have
> experience with DocBook and I would like that all the tutorial would be
made in DocBook format.
>
> Other parts that we can reuse is the Documentation that is in Mono CVS,
for examples, the README of each project explain well in that consists
and make a good introduction about the subject.
>
> Other subjects that I would add:
>
> 1. Adding extensions to our programs embedding Mono.
> 	1.1. With C.
> 	1.2. With Perl.
> 2. Mono LOGO.
> 3. Mono-guile.
> 4. Mono Debugger Framework (MDF)
> 	4.1. Backends.
> 	4.2. Frontends.
> 5. Monodoc.
> 6. Mono Tools:
> 	6.1. NUnit or NUnit2.
> 	6.2. NAnt.
> 	6.3. NGen.
> 	...
> 7. SharpDevelop a Free IDE in Windows part.
> 8. In GNOME Tutorial talk about some applications relative to some parts
like Platano, MPhoto, ..
>
> Only are some ideas, anybody want to propose anything more?
>
> Regards.
> --
> Alejandro Sanchez Acosta
>
> raciel@es.gnu.org			         GNU Spain is not Unix.
> raciel@gnome.org				 GNOME the GNU Desktop.
>