MoodleDocs:Starting MoodleDocs

Note: This article is a work in progress. Please use the page comments or an appropriate moodle.org forum for any recommendations/suggestions for improvement.

Would you like Moodle Docs in your language?

Please note that Moodle Docs in a new language needs:

• An administrator (or two)

The administrator should understand MediaWiki features such as page redirects, categories, templates and disambiguation pages. Please browse this wiki to discover how these features work.

• Lots of people wishing to contribute

Please find out how many people are interested by discussing Moodle Docs in your moodle.org community discussion course.

If you wish to start Moodle Docs in your language then please contact the Moodle Documentation Steward, Helen Foster, to arrange for a wiki https://docs.moodle.org/xx to be set up.

Things to do:

Initial pages

• Translate the Main Page, including links. (Please capitalize the first word of each page name e.g. [[Sandbox|sandbox]]).
• Create core category pages, with translated page names, using text from the language pack docs files.
• Create pages for Teacher documentation and Administrator documentation, plus corresponding category pages. (Developer documentation is optional.)
• Update the main navigation block and create the documentation block by translating MediaWiki:Sidebar.

Inter-language linking

• Add inter-language links by typing [[xx:Corresponding page title in the new language]] in the English MoodleDocs, and [[en:Corresponding page title in English]] in the new language Moodle Docs, at the bottom of the page, below the category link. Inter-language links will appear automatically in the "In other languages" block.

Moodle Docs pages

Translate the following, including page names:

• Help:Editing
• Help:Contents
• MoodleDocs:Guidelines for contributors
• MoodleDocs:Protected page (please respect protected pages)
• Optional: Additional Moodle Docs pages

System messages

Translate the following:

• MediaWiki:Loginprompt
• MediaWiki:Enotif body, MediaWiki:Enotif subject, MediaWiki:Enotif lastvisited, MediaWiki:Enotif newpagetext, MediaWiki:Changed, MediaWiki:Created (notification email)
• MediaWiki:Emailauthenticated

Depending upon the language, certain additional system messages may require translating, for example:

• MediaWiki:Talk (page comments)
• MediaWiki:Nstab-main
• MediaWiki:Edit
• MediaWiki:Viewsource
• MediaWiki:History short
• MediaWiki:Watch
• MediaWiki:Unwatch
• MediaWiki:Move
• MediaWiki:Protect
• MediaWiki:Unprotect
• MediaWiki:Delete
• MediaWiki:Specialpage
• MediaWiki:Recentchangestext

Link pages

• Create a set of link pages, leaving the names as file paths and simply adding translated categories.
• Move all link pages to provide translated page names.

Publicity

• Announce Moodle Docs in the moodle.org community discussion course.
• Add an RSS feed block to the community discussion course.