Differences between revisions 3 and 6 (spanning 3 versions)
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!
Revision 6 as of 2014-04-12 13:26:51
Size: 2416
Comment:
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
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. 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 as good as possible in all respects, especially the language.
Line 11: Line 11:
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. 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 idiomatic English and the text in question. We will in the future need to decide which N.A. English dialect we should use - American English is common on the Net, but Canadian English is closer to the British style which is more common globally.
Line 20: Line 20:
There is a full time job needed to make some sort of order in there... It is a full time job to make some sort of order in there...
Line 30: Line 30:
to be completed at will list to be completed at will.
Line 32: Line 32:
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". 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 would have to be maintained by hand and it's a huge task (in this period where many documents are being created), so it has yet to be done. In the meantime, 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 as 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 idiomatic English and the text in question. We will in the future need to decide which N.A. English dialect we should use - American English is common on the Net, but Canadian English is closer to the British style which is more common globally.

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.

It is a full time job 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.

list 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 would have to be maintained by hand and it's a huge task (in this period where many documents are being created), so it has yet to be done. In the meantime, use the MoinMoin "local site map" or "like pages".

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