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 :-)

-- 
http://www.dodin.net
http://dodin.org/galerie_photo_web/expo/index.html
http://lucien.dodin.net
http://fr.susewiki.org/index.php?title=Gérer_ses_photos

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to