Docs2

Moodle 2 Docs objectives

• Have a set of clear, user-friendly Docs for people to contribute to and read.

• Have a broad structure/overview (including a Table of Contents below) to:

- make it easy to clone/archive for each future version of Moodle and its dedicated Docs wiki.

- make it easier for community members to see where to create and find content (while free to edit and add pages, of course).

- make it easier to see what documentation is missing/outdated/irrelevant

- make it easier to link page URLs in Moodle releases to appropriate Docs page

Table of Contents - a map of pages and templates

The Table of Contents below is a map of pages and templates that appear on (some of) them.

Imagine a template (box of links on the right side, example) on the page for each indented item. For example (using the table below), Page 1. will have a template with items 1.1.1 - 1.1.7, page 1.1.4 will have items 1.1.4.1 - 1.1.4.4 etc).

If we want a stricter control over templates as the organising feature of Table of Contents, we could perhaps lock them and only a few people can make changes to keep a reasonable structure (will help in cloning new version wikis).

The useful links in creating each page (check the initial Docs 2.0 draft) will be inserted into page comments for each page to help community members build the wiki but with information customised for Moodle 2.x.

Templates for activities explained:

• 'Activity' Settings

Corresponds with Settings [block]-> 'Activity' administration menu -> Edit settings, hence the name used. Include permissions.

This is the first stage (add/update) of two-step activities (Database, Lesson, Feedback, Quiz).

Guide the user through the options available ON THIS PAGE ONLY, before they click 'Save and display'.

• Building 'Activity' (Database, Lesson, Feedback and Quiz only)

What the creator (eg. teacher) needs to know after the initial setup ('Activity' settings) in building the activity before it is opened to participants (eg. students).

• Using 'Activity'

Everything AFTER the activity is open to participants. Things like viewing, posting, grading, results, analysis, reports, good practices, examples, pedagogical implications.

This should provide enough 'room' for community members to create new pages and content without being too prescriptive in what they should write.

Strange remarks

Legend to remarks, temporary only from a doc that helps (Tomaz) keep track of what (template) links to what. These will be deleted in the final wiki.

[P] = Primary article
[link] = Link to primary article. No editing here, only edit the primary article [P].
[RD] = Redirect. From similar (sounding) articles.
[Eq. to …] = Equivalent to ...

Getting your Moodle [P]

==Download packages

Managing Moodle site [P]

Security

Common security risks [P]

===Security overview