On Wednesday 08 February 2006 09:25, jdd wrote:

Translating the present pages, I noted some remarks. Please, see this only as discussion notes. If you agree with them (after editing them as much as you want) it could be a good idea to make a wiki page.

I don't really know of the english/us habits, but I was for a long time a french author and editor (books, may be the olders of you remember the HP-41 days - I had books translateds in english and edited in USA, also in Netherland) and periodics.

Of course there are many times where rules must _not_ be followed, but to do this, we needs rules :-)))

jdd

small remarks on the subject of article writing and section handling.

It's a good practice (anywhere, not only in the wiki)

* to don't make unnecessary cascading subsections.

just an example, the toc here

http://en.opensuse.org/SDB:Howto

has a "2 Procedures" section with 3 more levels sub-sections and many of them before reaching the "3 Links". It should probably be better to move up one level the 2.4 SDB tags.

it's not always easy to do, however :-), but usually we should use only "==" and "==="

* when sub-sections are used, one sub-section title must follow immediately the section title, with almost no text between them.

again only as an example:

http://en.opensuse.org/SDB:Howto#Syntax

There should be a sub-section after Syntax, for example "==== Basics ===="

this is specially important with the way mediawiki opens the editor window, to have just openned the relevant part.

Usually, if there is a real need for more than two levels, it's best to open a new page (the table of content should not be more than a page hight :-)

IMHO the example page for few purposes will help more than thousand words. If you can give skeleton to start from I'm sure that there will be some people ready to continue. You may create that in your French area and than it could be translated to English. -- Regards, Rajko.

On Wednesday 08 February 2006 09:25, jdd wrote:

Translating the present pages, I noted some remarks. Please, see this only as discussion notes. If you agree with them (after editing them as much as you want) it could be a good idea to make a wiki page.

I don't really know of the english/us habits, but I was for a long time a french author and editor (books, may be the olders of you remember the HP-41 days - I had books translateds in english and edited in USA, also in Netherland) and periodics.

Of course there are many times where rules must _not_ be followed, but to do this, we needs rules :-)))

jdd

small remarks on the subject of article writing and section handling.

It's a good practice (anywhere, not only in the wiki)

* to don't make unnecessary cascading subsections.

just an example, the toc here

http://en.opensuse.org/SDB:Howto

has a "2 Procedures" section with 3 more levels sub-sections and many of them before reaching the "3 Links". It should probably be better to move up one level the 2.4 SDB tags.

it's not always easy to do, however :-), but usually we should use only "==" and "==="

* when sub-sections are used, one sub-section title must follow immediately the section title, with almost no text between them.

again only as an example:

http://en.opensuse.org/SDB:Howto#Syntax

There should be a sub-section after Syntax, for example "==== Basics ===="

this is specially important with the way mediawiki opens the editor window, to have just openned the relevant part.

Usually, if there is a real need for more than two levels, it's best to open a new page (the table of content should not be more than a page hight :-)

IMHO the example page for few purposes will help more than thousand words. If you can give skeleton to start from I'm sure that there will be some people ready to continue. You may create that in your French area and than it could be translated to English. -- Regards, Rajko.