Obsolete:Moodle Docs development: Difference between revisions
From MoodleDocs
(Other multilingual documentation wikis) |
Helen Foster (talk | contribs) (features to consider using) |
||
| Line 1: | Line 1: | ||
==MoodleDocs links== | ==MoodleDocs links== | ||
Moodle 1.6 will have a button | Moodle 1.6 will have a button on each page that links to pages in the wiki with the same path as the pages in Moodle e.g. the Forums index page will link to [[mod/forum/index]]. You can see this already on [http://moodle.org/ moodle.org]. | ||
==MoodleDocs in other languages== | ==MoodleDocs in other languages== | ||
*Moodle documentation is required in every language! | *Moodle documentation is required in every language! Let's start with one or two additional languages - ''any voluteers please email docs AT moodle DOT org!'' | ||
*MoodleDocs in other languages will enable many people to be involved in creating documentation, rather than just a select few. | *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. | *Each version will contain the language code in the URL e.g. docs.moodle.org/es/..., docs.moodle.org/de/... etc. | ||
| Line 11: | Line 11: | ||
*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. | ||
*[[:Category:Core|Core category]] pages | *[[:Category:Core|Core category]] pages will 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). | *'''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. | *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. (This would only be used for certain pages, not Moodle file path named pages.) | ||
*Features to consider using: [[Special:Export|Export pages]] and [[Special:Import|Import pages]] | |||
===Language links=== | ===Language links=== | ||
Revision as of 11:41, 25 January 2006
MoodleDocs links
Moodle 1.6 will have a button on each page that links to pages in the wiki with the same path as the pages in Moodle e.g. the Forums index page will link to mod/forum/index. You can see this already on moodle.org.
MoodleDocs in other languages
- Moodle documentation is required in every language! Let's start with one or two additional languages - any voluteers please email docs AT moodle DOT org!
- 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 will 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. (This would only be used for certain pages, not Moodle file path named pages.)
- Features to consider using: Export pages and Import pages
