Re: dcoumentation: handbook, cookbook

[ Thread Index | Date Index | More lists.tuxfamily.org/slitaz Archives ]


Hi guys,

First, sorry about the previous blank message, my mistake, I clicked in the wrong button.

So here it goes: I'm starting to do updates in the pt sections of http://doc.slitaz.org/ and also having a nice chat with Claudinei about it. So I came with the following issues:
- from SliTaz's site start page
(http://slitaz.org/en/index.html , in English and other languages), when we click at "Documentation" in the vertical menu called "Navigation" we are directed to http://slitaz.org/en/doc/index.html instead of http://doc.slitaz.org/ . Just in the menu bellow "SliTaz Network" we have an entry for "Wiki Documentation", which lead us to http://doc.slitaz.org/en:start . I think it is not clear. And isn't the idea of "Summer of Documentation" to centralize the documentation in DokuWiki? I would suggest to we delete the first entry (leading us to http://slitaz.org/en/doc/index.html) OR we should have the two enties one above the other, the first called something like "Official Documentation" and the "Community Documentation". What you guys think?
- the start documentation page (http://doc.slitaz.org/) brings very useful information about the "Summer of Documentation", but it is not possible to translate it via DokuWiki. Would it be possible to add muiti-language support to it too? Because I believe it would useful to non-English speakers to know more about the "Summer of Documentation".
- and, finally, who is coordinating the English documentation? Because Claudinei and I notice that some information in the Handbook, for instance, needs updates (in English, Portuguese, and I believe it is the same in other languages). So to avoid duplicate work, I think it is best to us to centralize first the updates in English, then start the updates for other languages.

I believe that's all.

Att.,

BC




---- On Fri, 14 May 2010 12:07:08 -0300 Rohit Joshi <rj.rohit@xxxxxxxxx> wrote ----

Hi all,

I am pleased to see that some of you are taking interest in improving
Slitaz documentation.

Just a reminder: If you are formatting handbook and cookbook, please
do not remove (just edit) any previously written code in <code> tags
unless you know that code or a particular option is no more valid
with 3.0.

Thanks

Rohit

---
SliTaz GNU/Linux Mailing list - http://www.slitaz.org/




Mail converted by MHonArc 2.6.19+ http://listengine.tuxfamily.org/