MoodleDocs:Moodle Docs development: Difference between revisions
From MoodleDocs
Helen Foster (talk | contribs) (MoodleDocs in other languages) |
Helen Foster (talk | contribs) (MoodleDocs in other languages, see also) |
||
Line 1: | Line 1: | ||
==MoodleDocs links== | ==MoodleDocs links== | ||
Moodle 1.6 will have a button in the header that links to pages in MoodleDocs with the same path as the pages in Moodle e.g. the Forums index page | Moodle 1.6 will have a button in the header that links to pages in MoodleDocs with the same path as the pages in Moodle e.g. the Forums index page will link to [[mod/forum/index]]. | ||
==MoodleDocs in other languages== | ==MoodleDocs in other languages== | ||
*Moodle documentation is required in every language! | *Moodle documentation is required in every language! | ||
*Each version will contain the language code in the URL e.g. | *MoodleDocs in other languages will enable many people to be involved in creating documentation, rather than just a select few. | ||
*Each version will contain the language code in the URL e.g. docs.moodle.org/es/..., docs.moodle.org/de/... etc. | |||
*[http://moodle.org/help.php?file=index.html Moodle help files] will remain in each [[MoodleDocs and lang packs|language pack]] for those using Moodle locally without an Internet connection. | *[http://moodle.org/help.php?file=index.html Moodle help files] will remain in each [[MoodleDocs and lang packs|language pack]] for those using Moodle locally without an Internet connection. | ||
*All documentation contributions should be encouraged, including creating new pages i.e. contributors should not be restricted to only translating English pages. | *All documentation contributions should be encouraged, including creating new pages i.e. contributors should not be restricted to only translating English pages. | ||
*Essential documentation should be decided upon and assigned to a [[:Category:Core|core category]]. All these pages should be translated. | *Essential documentation should be decided upon and assigned to a [[:Category:Core|core category]]. All these pages should be translated. | ||
*MediaWiki page titles are the same as the last part of the URL, however these may be translated by moving the page and so creating a redirect e.g. | *[[:Category:Core|Core category]] pages should have interlanguage links. | ||
*'''Translation will be multi-directional''' i.e. not just translation from English into other languages (e.g. a Spanish developer writes documentation in Spanish which is then translated into other languages). | |||
*MediaWiki page titles are the same as the last part of the URL, however these may be translated by moving the page and so creating a redirect e.g. docs.moodle.org/nl/Metacourses moved to docs.moodle.org/nl/Koepelcursus. | |||
*Useful language links: | *Useful language links: | ||
**[http://en.wikipedia.org/wiki/Wikipedia:Interlanguage_links Wikipedia:Interlanguage links] | **[http://en.wikipedia.org/wiki/Wikipedia:Interlanguage_links Wikipedia:Interlanguage links] | ||
**[http://meta.wikimedia.org/wiki/Meta:Conventions_for_multilingualism Meta:Conventions for multilingualism] | **[http://meta.wikimedia.org/wiki/Meta:Conventions_for_multilingualism Meta:Conventions for multilingualism] | ||
**[http://meta.wikimedia.org/wiki/Help:Interwiki_linking Help:Interwiki linking] - | **[http://meta.wikimedia.org/wiki/Help:Interwiki_linking Help:Interwiki linking] | ||
**[http://developer.mozilla.org/en/docs/Main_Page Mozilla Developer Center] - an example of documentation in other languages | |||
==See also== | |||
*[[Documentation philosophy]] | |||
==External links== | ==External links== |
Revision as of 22:40, 22 January 2006
MoodleDocs links
Moodle 1.6 will have a button in the header that links to pages in MoodleDocs with the same path as the pages in Moodle e.g. the Forums index page will link to mod/forum/index.
MoodleDocs in other languages
- Moodle documentation is required in every language!
- MoodleDocs in other languages will enable many people to be involved in creating documentation, rather than just a select few.
- Each version will contain the language code in the URL e.g. docs.moodle.org/es/..., docs.moodle.org/de/... etc.
- Moodle help files will remain in each language pack for those using Moodle locally without an Internet connection.
- All documentation contributions should be encouraged, including creating new pages i.e. contributors should not be restricted to only translating English pages.
- Essential documentation should be decided upon and assigned to a core category. All these pages should be translated.
- Core category pages should have interlanguage links.
- Translation will be multi-directional i.e. not just translation from English into other languages (e.g. a Spanish developer writes documentation in Spanish which is then translated into other languages).
- MediaWiki page titles are the same as the last part of the URL, however these may be translated by moving the page and so creating a redirect e.g. docs.moodle.org/nl/Metacourses moved to docs.moodle.org/nl/Koepelcursus.
- Useful language links:
- Wikipedia:Interlanguage links
- Meta:Conventions for multilingualism
- Help:Interwiki linking
- Mozilla Developer Center - an example of documentation in other languages
See also
External links
- How to become a MediaWiki hacker ;-)
- Category:Mediawiki Extensions
- MDC:Custom CSS Classes - for styling ideas