| 1 |
>> On Saturday 18 of February 2006 03:35, Henryk Konsek wrote: |
| 2 |
>> Hi. |
| 3 |
>> As far as I know there is not section in Gentoo documentation |
| 4 |
>> concerning Zsh configuration. I've written sample article covering |
| 5 |
>> basic Zsh installation and configuration issues. I would be |
| 6 |
>> grateful for any feedback concerning my doc. |
| 7 |
>> |
| 8 |
>> Greetings. |
| 9 |
>> HK |
| 10 |
|
| 11 |
Hi Henryk, |
| 12 |
thank you for writing this. We appreciate your efforts. :-) |
| 13 |
|
| 14 |
Gentoo documentation is written in guideXML. It is a very simple markup |
| 15 |
language similar to HTML. Although we will still accept your submission |
| 16 |
in HTML, someone will have to convert it for you and we are all |
| 17 |
volunteers. If you want to help out and do this yourself you can read |
| 18 |
the documents listed below. Also, as you probably know, Gentoo docs are |
| 19 |
offered in many languages. If you want to translate to any language you |
| 20 |
read/write we would appreciate it very much! |
| 21 |
|
| 22 |
This is a HOWTO on using the guideXML markup language. This is the only |
| 23 |
document you have to read in order to make your document guideXML. The |
| 24 |
others are all optional depending on how much you want to do. |
| 25 |
|
| 26 |
http://www.gentoo.org/doc/en/xml-guide.xml |
| 27 |
|
| 28 |
|
| 29 |
This one is a little technical. It covers how to set up a local testing |
| 30 |
environment to ensure your guideXML is error free. You don't have to do |
| 31 |
this if you don't want to. The docs team will take care of it for you if |
| 32 |
you don't want to or don't have the time. |
| 33 |
|
| 34 |
http://www.gentoo.org/proj/en/gdp/doc/doc-tipsntricks.xml |
| 35 |
|
| 36 |
|
| 37 |
This one shows you the steps your document will go through in order to |
| 38 |
be accepted and put on the website. You can do as many or as little of |
| 39 |
the steps you want yourself. The docs team will fill in the rest. |
| 40 |
|
| 41 |
http://www.gentoo.org/proj/en/gdp/doc/doc-policy.xml |
| 42 |
|
| 43 |
We submit docs to bugs.gentoo.org, you can start a new bug and assign it |
| 44 |
to the docs-team as a new document and attach your document to the bug. |
| 45 |
|
| 46 |
Here is a direct link that will open a new bug report assigned to the |
| 47 |
docs team. Just make sure to click "New Documentation" under the |
| 48 |
Component option. |
| 49 |
|
| 50 |
Thanks again! |
| 51 |
|
| 52 |
--curtis |
| 53 |
-- |
| 54 |
gentoo-doc@g.o mailing list |
Archives