Moodle documentation: Most Wanted Pages - Docs 2, June 2011

Moodle documentation: Most Wanted Pages - Docs 2, June 2011

by Tomaz Lasic -
Number of replies: 2

OK dear moodlers, here is a rough list of pages in the new Docs 2 that are in need of either creating or updating. The list is neither final nor exclusive but it does point out a few key 'to do's':

Please note:

* (asterisk) indicates that this is an empty 'launchpad' page - brief introduction to several pages on the topic (mostly found on the page template),
example http://docs.moodle.org/20/en/Managing_a_Moodle_site

- when editing these, please inform/help yourself with Page notes for each of these pages.

Top editing priorities (June 2011):

- All Activities [http://docs.moodle.org/20/en/Activity] and their 'Settings', 'Building' (if applicable), 'Using', 'FAQ' as indicated in template:
(reminder re templates: 'Settings' - everything BEFORE activity opened to students, 'Building' - AFTER initial setup and BEFORE opened to students (if applicable), 'Using' - everything AFTER opening to students).

http://docs.moodle.org/20/en/Assignment
http://docs.moodle.org/20/en/Chat
http://docs.moodle.org/20/en/Choice (not critical, getting incorporated in another module soon…)
http://docs.moodle.org/20/en/Database_activity_module
http://docs.moodle.org/20/en/Feedback (not critical, getting incorporated in another module soon…)
http://docs.moodle.org/20/en/Forum
http://docs.moodle.org/20/en/Glossary
http://docs.moodle.org/20/en/Lesson
http://docs.moodle.org/20/en/Quiz (speaking to Tim Hunt and Phil Butcher, please and thank you)
http://docs.moodle.org/20/en/SCORM_module (Amy Groshek, please & thank you)
http://docs.moodle.org/20/en/Survey (not critical, getting incorporated in another module soon…)
http://docs.moodle.org/20/en/Wiki
http://docs.moodle.org/20/en/Workshop

- All Resources [http://docs.moodle.org/20/en/Resources] :
http://docs.moodle.org/20/en/File (badly in need of update; article and related template items - Settings, Using File, FAQ!)
http://docs.moodle.org/20/en/Folder (needed, badly! article and related template items - Settings, Using, FAQ!))
http://docs.moodle.org/20/en/IMS_package (needed, badly! article and related template items - Settings, Using, FAQ!))
http://docs.moodle.org/20/en/Label (need related template items - Settings, Using, FAQ)
http://docs.moodle.org/20/en/Page (needed, badly! article and related template items - Settings, Using, FAQ!))
http://docs.moodle.org/20/en/URL (needed, badly! article and related template items - Settings, Using, FAQ!))

http://docs.moodle.org/20/en/Working_with_files_and_folders (a very contentious issue out there, need a clear, concise doc here - not to confuse new Moodle users and load with 1.9 related info…)
http://docs.moodle.org/20/en/File_handling
http://docs.moodle.org/20/en/Differences_between_Moodle_1.x_and_2.x

http://docs.moodle.org/20/en/Moodle_site_-_basic_structure * and related:
http://docs.moodle.org/20/en/Category
http://docs.moodle.org/20/en/My_Profile

http://docs.moodle.org/20/en/Working_with_media * and related:
http://docs.moodle.org/20/en/Video
http://docs.moodle.org/20/en/Images
http://docs.moodle.org/20/en/Embedding content

Full list of missing/need update pages (by main sections of Docs) ... please copy/paste these URLs, the linking is getting a bit tedious tongueout  Thanks

'About Moodle' section
http://docs.moodle.org/20/en/Glossary_of_Moodle_terms *
http://docs.moodle.org/20/en/Moodle_community *
http://docs.moodle.org/20/en/Moodle_mobile *
http://docs.moodle.org/20/en/Accessibility
http://docs.moodle.org/20/en/Moving_to_Moodle_2

'Getting Moodle' section
http://docs.moodle.org/20/en/Try_Moodle *

'Managing a Moodle site'
http://docs.moodle.org/20/en/Moodle_site_-_basic_structure *
http://docs.moodle.org/20/en/Category
http://docs.moodle.org/20/en/My_Profile
http://docs.moodle.org/20/en/Custom_menu_items
http://docs.moodle.org/20/en/Editing_settings *
http://docs.moodle.org/20/en/'Turn_editing_on'_button
http://docs.moodle.org/20/en/Editing_icons_and_menus
http://docs.moodle.org/20/en/Managing_site_users *
http://docs.moodle.org/20/en/Accounts *
http://docs.moodle.org/20/en/Create_custom_roles
http://docs.moodle.org/20/en/Themes (update critical on most Theme-related articles!)
http://docs.moodle.org/20/en/Managing_blocks *
http://docs.moodle.org/20/en/Blocks_2.0 (update, create missing ones in red)
http://docs.moodle.org/20/en/Sitewide_display_settings * (plus a number of items on that template -> check)
http://docs.moodle.org/20/en/Comments_2.0 (see all template items: Settings, Using Comments & FAQ)
http://docs.moodle.org/20/en/Blogs (see template items: Settings, Using Blogs, Blog association)
http://docs.moodle.org/20/en/Messaging (see template items: Settings, Using messaging)
http://docs.moodle.org/20/en/Notes (see template items: Settings, Using Notes, Notes association, FAQ)
http://docs.moodle.org/20/en/Tags (see template items: Settings, Using Tags, Tags association, FAQ
http://docs.moodle.org/20/en/Calendar (see Settings)
http://docs.moodle.org/20/en/Common_security_risks
http://docs.moodle.org/20/en/Site-wide_communication_tools *
http://docs.moodle.org/20/en/Server_settings *
http://docs.moodle.org/20/en/Networking *
http://docs.moodle.org/20/en/Sitewide_reports *
http://docs.moodle.org/20/en/Config_changes_report
http://docs.moodle.org/20/en/Extending_standard_Moodle *
http://docs.moodle.org/20/en/Contributed_modules,_plugins,_filters
http://docs.moodle.org/20/en/Contrib_guidelines
http://docs.moodle.org/20/en/Contrib_FAQ
http://docs.moodle.org/20/en/Developer_tools * (check items on the template, Mnet test client, Purge all caches, Transfer database and Export database need creating)

'Managing a Moodle course'
http://docs.moodle.org/20/en/Creating_a_course and http://docs.moodle.org/20/en/Course_settings (need to merge those two really…)
http://docs.moodle.org/20/en/Course_appearance *
http://docs.moodle.org/20/en/Standard_course_formats *
http://docs.moodle.org/20/en/Course_enrolment *
http://docs.moodle.org/20/en/Grouping_users *
http://docs.moodle.org/20/en/Course_security *
http://docs.moodle.org/20/en/Re-using_courses_and_activities *
http://docs.moodle.org/20/en/Clone_resource/activity
http://docs.moodle.org/20/en/Share_within_your_Moodle
http://docs.moodle.org/20/en/Search_for_courses
http://docs.moodle.org/20/en/Advertise_courses
http://docs.moodle.org/20/en/Share_courses
http://docs.moodle.org/20/en/Import_courses_from_hubs

'Learning and evaluation tools'
http://docs.moodle.org/20/en/File (badly in need of update; article and related template items - Settings, Using File, FAQ!)
http://docs.moodle.org/20/en/Folder (needed, badly! article and related template items - Settings, Using, FAQ!))
http://docs.moodle.org/20/en/IMS_package (needed, badly! article and related template items - Settings, Using, FAQ!))
http://docs.moodle.org/20/en/Label (need related template items - Settings, Using, FAQ)
http://docs.moodle.org/20/en/Page (needed, badly! article and related template items - Settings, Using, FAQ!))
http://docs.moodle.org/20/en/URL (needed, badly! article and related template items - Settings, Using, FAQ!))

All Activities and their Settings, Using, FAQ !!!

http://docs.moodle.org/20/en/Tracking_progress *
http://docs.moodle.org/20/en/Conditional_activities (needs Settings, Using, FAQ need work)
http://docs.moodle.org/20/en/Activity_completion (needs Settings, Using, FAQ)
http://docs.moodle.org/20/en/Course_completion (needs Settings, Using, FAQ)

http://docs.moodle.org/20/en/Course_reports *
http://docs.moodle.org/20/en/Course_completion_report

'Managing content' section
http://docs.moodle.org/20/en/Working_with_files_and_folders
http://docs.moodle.org/20/en/Differences_between_Moodle_1.x_and_2.x
http://docs.moodle.org/20/en/Working_with_media *
http://docs.moodle.org/20/en/Video
http://docs.moodle.org/20/en/Images
http://docs.moodle.org/20/en/Embedding content
http://docs.moodle.org/20/en/Editing_text *
http://docs.moodle.org/20/en/Repositories (check for accuracy!!!)
http://docs.moodle.org/20/en/Repositories (missing pages for Amazon S3, Google Docs
Merlot, Picasa, Recent files, Server files, Upload a file, YouTube, Custom external repositories)
http://docs.moodle.org/20/en/Portfolios (missing pages for File download, Google Docs, Flickr, Picasa, Custom external portfolio - please note that if something acts as both repo and portfolio we only need one page, eg. Google Docs)

http://docs.moodle.org/20/en/Copyright_and_plagiarism *

Once again, this list is NOT exclusive. If you find a page not mentioned here but needed of an update/creation ... by all means go ahead!

Fire away and happy editing/creating. See you in the Docs (or here, of course)

THANK YOU ! cool

Average of ratings: -
In reply to Tomaz Lasic

Re: Moodle documentation: Most Wanted Pages - Docs 2, June 2011

by Visvanath Ratnaweera -
Picture of Particularly helpful Moodlers Picture of Translators
Hi Tomaz

I went through the list and noticed that most of the them are completely empty, in both versions, /19/ and /20/.

My question is, how did they appear in the first place? The way I understand a wiki, a person conversant in a certain topic creates a page to add his knowledge to the database. How is it possible for a such a vast of number of empty pages to pop up, that puzzles me.
In reply to Tomaz Lasic

Re: Moodle documentation: Most Wanted Pages - Docs 2, June 2011

by Chris Collman -
Picture of Documentation writers

Tomaz and others, Thanks for the List, Notes and TOC !!!,

I did not see this post earlier.  In the last week or so, I have tried to spirial out from the Main page to put at least an introduction on pages with just the yellow banner and in subjects in their related template.  I did not try to focus a great deal on the "settings" or "how to".  I did not worry about 1.9 blank pages.  

My process was to write what I thought was needed, check it against demo.moodle,  then to click on the notes to see if I missed anything.  I left the banner in most cases (perhaps an error?).   And I tried to link to other pages in the text.   

I have gone into the simple "how to" with pages when  I have recently used the feature on our 2.1 Moodle sites.   I took some interesting side trips trying to find things in the Settings menu or why they did not show up in demo.moodle (or my site). 

In retrospect it might have been easier to use a category tag but I recognize how much work when into both the ioverall TOC and the notes.  I am thinking that I should have changed the banner, and perhaps put the link to the Notes in the "See also".  

I did try to teach my spell checker on my new computer some of the more quaint English spellings but someetimes my fingers have a mind of their own.

Best wishes to all, Chris