Posts made by Martin Dougiamas

Picture of Core developers Picture of Documentation writers Picture of Moodle HQ Picture of Particularly helpful Moodlers Picture of Plugin developers Picture of Testers

You need to take these case-by-case I think.

Please remember that the main docs are now focussed on being user docs, about the Moodle software itself.

1) Performance is version-specific.  They will vary more and more.  It makes sense to have versioned pages.  And yes there will be common stuff ... people need to start being aware of which version they are editing and remember to update the latest as well (if they aren't already doing so).

2) These sort of pages (installation/upgrades) are extremely version-specific, and also good candidates to add specific links to other versions of the page to help people get to the right place.

3) Code of conduct, and anything else like that which is not part of the user documentation for Moodle itself should go to other places.  Policy stuff can move straight on moodle.org as a normal uneditable web page.  The list of user groups could go into a Moodle wiki on moodle.org, or a database.  Anything development-related must move to the development wiki (that includes versions, release notes and roadmaps etc).

Picture of Core developers Picture of Documentation writers Picture of Moodle HQ Picture of Particularly helpful Moodlers Picture of Plugin developers Picture of Testers

I think the issue is that more and more of docs are becoming version-specific, even things like performance.

As time goes on cramming that information into one wiki is much worse than clear, separate user manuals for each version, where the search only covers what you need.

This page shows the wiki structure:  http://docs.moodle.org/overview/

Average of ratings: Useful (1)
Picture of Core developers Picture of Documentation writers Picture of Moodle HQ Picture of Particularly helpful Moodlers Picture of Plugin developers Picture of Testers

Just an update on Docs ... I plan to be personally getting stuck into these for the next week or two to wrangle them to the ground a bit more, removing duplicates and so on. At the same time will develop a clearer TODO list for further development.

The trouble is that a lot of changes are still incomplete but that's all in people's heads, and it's not obvious from looking at docs as they are now.   Also there are some important pages about Moodle functions that are just factually wrong, which I also need to work on.

I hope everything is much clearer soon!

Picture of Core developers Picture of Documentation writers Picture of Moodle HQ Picture of Particularly helpful Moodlers Picture of Plugin developers Picture of Testers

+100 on WebDAV. Tim has described it well.

The main thing allowing write access would be Private Files, that's easy to manage as it's all one user and you have full privs.

Secondly would be "folder" and "file" resources, and possibly legacy course file areas.

More could be added later.