Development:Wiki requirements

Moodle wiki purpose

To provide a way for students, teachers and other Moodle participants to create an organic, on-line document collaboratively.

Key features

1. Pages can be created and linked using simple wiki methods.
2. All Moodle text formats can be supported.
3. Editing and viewing can be restricted by Moodle roles (i.e. currently, Students, Groups, Teachers).
4. Images can be easily inserted into the text of a wiki.
5. Attachments can be made to wiki pages.
6. Must be fully compliant with Moodle backup and restore.
7. Must be fully compliant with Moodle logging and activity tracking.
8. Must provide a method of grading (see assignment module). Grading should be optional on a per-wiki basis.
9. Allow inporting of external documents to create a wiki or add to an exiting one.
10. Allow exporting to an external document.
11. Allow refactoring/moving/deleting pages with appropriate permissions

(from Martin's list):

• The Wiki should support exactly the same text formats in Moodle core as you find everywhere else (see weblib.php for standard functions, eg format_text). ie Moodle format, HTML format, Markdown, etc. Any new formats need to go in the core so they are available everywhere, and this needs to be discussed very well. We only JUST removed the old Wiki-like format to reduce confusion with the current Wiki and I don't want more of this confusion from a rushed implementation.

• Linking should support both CamelCase and [Bracket] styles, and also automatic linking on the fly (a la Glossary).

• Upgrading from the old system to any new one should be seamless and problem-free (this includes restoring old backups from 1.4, for example).

• The idea with eWiki was to build on the work of the eWiki team in future. Unfortunately, so many hacks needed to be made to their monolithic script that this became almost impossible. I would like to see a lot of thought put into a very cleanly-designed architecture for the Wiki in future, something that is easy to extend and maintain (and also to use).

• I really like MediaWiki, as this Wiki is becoming a defacto standard (for good reason) and it would be good to be compatible in some way with it. Perhaps we can use part of it as a library for us. However, the Moodle Wiki is a COMPONENT within the larger Moodle system and has a very different focus to MediaWiki (which is designed for large standalone web sites) ... much thought should be given to making our Wiki work very closely with other modules, rather than another module that tries to do everything itself. It should do exactly what it needs to do and no more.

• Support for media in a very clean way is a must. This is probably my biggest criticism of the current eWiki version ... attaching images and video etc is really awkward and doesn't look good.

See also

• Wiki development forum discussion
• Dfwiki