Differences between revisions 2 and 3
Revision 2 as of 2008-10-30 16:22:23
Size: 2136
Editor: jdd
Comment:
Revision 3 as of 2008-10-31 19:12:11
Size: 2206
Comment: Some syntax changes and spelling corrections in English english, rather than North American english, I' afraid!
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
this page is intended as a help for people brosing the wiki to fix langage errors. this page is intended as a help for people browsing the wiki to fix language errors.
Line 3: Line 3:
= For langage = = For language =
Line 6: Line 6:
Many people in the LDP are not english natives and they english can be worst than desirable (specially mine :-) [[jdd]]). However, the LDP being devoted to documentation, the LDP document, including the wiki, have to be a good as possible on all respects, including langage. Many people in the LDP are not English natives and the standard of their english may be less than desirable (especially mine :-) [[jdd]]). However, the LDP being devoted to documentation, the LDP documentation, including the wiki, has to be a good as possible in all respects, especially the language.
Line 8: Line 8:
The langage should never be an obstacle for people having a good Linux knowledge and wanting to write on ther wiki or to writer HOWTOs, so we need langage reviewers. The language should never be an obstacle for people improving their Linux knowledge and wanting to contribute to the wiki or to write HOWTOs, so we need language reviewers.
Line 11: Line 11:
We can say that the LDP default langage is North American English. So the langage should be fixed accordingly, each time there is a difference between enlgish idioms. We can say that the LDP default language is North American English. So the language should be corrected accordingly, every time there is a difference between iodiomatic english and the text in question.
Line 13: Line 13:
People wanting to help as langage reviewer, should browse the "Recent changes" page and look for errors. This is probably not really necessary on preliminary documents, as content may change often, but when a document is near completion, it's very important. People wanting to help as language reviewer, should browse the "Recent changes" page and look for errors. This is probably not really necessary on preliminary documents, as content may change often, but when a document is near completion, it's very important.
Line 15: Line 15:
Authors are asked to use [[Ldp admonitions page|admonitions]] to flag pages needing review, but current pages can't have such adonition and need badly reviews :-). Authors are asked to use [[Ldp admonitions page|admonitions]] to flag pages needing review, but current pages can't have such admonition and badly need reviews :-).
Line 32: Line 32:
Any new pages should have at least a link from his writer's own page, then a link from the relevant place. It could be usefull to make a "site map", but this have to be maintained by hand and it's a hudge task (only on this period where many things are created), so have yet to be done. In the ean time, use the MoiMoin "local site map" or "like pages". Any new pages should have at least a link to the writer's own page, then a link to the relevant place. It could be useful to make a "site map", but this have to be maintained by hand and it's a huge task (only in this period where many things are created), so has yet to be done. In the mean time, use the MoinMoin "local site map" or "like pages".

this page is intended as a help for people browsing the wiki to fix language errors.

For language

Why

Many people in the LDP are not English natives and the standard of their english may be less than desirable (especially mine :-) jdd). However, the LDP being devoted to documentation, the LDP documentation, including the wiki, has to be a good as possible in all respects, especially the language.

The language should never be an obstacle for people improving their Linux knowledge and wanting to contribute to the wiki or to write HOWTOs, so we need language reviewers.

How

We can say that the LDP default language is North American English. So the language should be corrected accordingly, every time there is a difference between iodiomatic english and the text in question.

People wanting to help as language reviewer, should browse the "Recent changes" page and look for errors. This is probably not really necessary on preliminary documents, as content may change often, but when a document is near completion, it's very important.

Authors are asked to use admonitions to flag pages needing review, but current pages can't have such admonition and badly need reviews :-).

For coherence

A wiki is a mess... any page can be created nearly anywhere and with any purpose.

There is a full time job needed to make some sort of order in there...

The LDP wiki should be organised like this:

  • Home page

    • Members page help and infos for members (regular wiki writers)

    • Author page help and infos for Authors (HOWTO and Guides writers)

    • Visitors page help for any newcommer or people seeking for documentation

  • HOWTO Forge place where are the HOWTOs being worked on.

to be completed at will

Any new pages should have at least a link to the writer's own page, then a link to the relevant place. It could be useful to make a "site map", but this have to be maintained by hand and it's a huge task (only in this period where many things are created), so has yet to be done. In the mean time, use the MoinMoin "local site map" or "like pages".

Browse the wiki (last edited 2014-04-12 13:26:51 by Jack Ditchburn)