Documentation philosophy: diferència entre les revisions
De MoodleDocs
Cap resum de modificació |
Cap resum de modificació |
||
| (6 revisions intermèdies per 4 usuaris que no es mostren) | |||
| Línia 1: | Línia 1: | ||
* Focus on ''' | {{Help}} | ||
* Transfer content from [http://moodle.org/course/view.php?id=5 Using Moodle] forum discussions (e.g. answers to how-to questions, ideas/suggestions of ways of using a particular feature) to | |||
* Encourage newcomers to contribute to | * Focus on '''Moodle Docs''' as the central Moodle knowledge-base | ||
* Transfer content from [http://moodle.org/course/view.php?id=5 Using Moodle] forum discussions (e.g. answers to how-to questions, ideas/suggestions of ways of using a particular feature) to Moodle Docs | |||
* Encourage newcomers to contribute to Moodle Docs | |||
:"New users are ideal for writing system-level documentation aimed at new users. They have the point of view and experience with the current software at the system level rather than at the library level. The most common evidence of this is FAQ lists, in which issues repeatedly raised on mailing lists and chat sessions are answered." Source: [http://www.oss-watch.ac.uk/resources/documentation.xml Documentation issues in open source] | :"New users are ideal for writing system-level documentation aimed at new users. They have the point of view and experience with the current software at the system level rather than at the library level. The most common evidence of this is FAQ lists, in which issues repeatedly raised on mailing lists and chat sessions are answered." Source: [http://www.oss-watch.ac.uk/resources/documentation.xml Documentation issues in open source] | ||
* Encourage Using Moodle regulars to contribute to | * Encourage Using Moodle regulars to contribute to Moodle Docs by adding content in response to a question in the forums, then provide a link to the Moodle Docs page in the forum discussion | ||
* Provide "See also" links in | * Provide "See also" links in Moodle Docs to additional information in Using Moodle discussions e.g. [[Forums]] (though if the Using Moodle discussion leads to a conclusion/agreement then this should be transferred to MoodleDocs) | ||
==See also== | |||
*[[MoodleDocs development]] | |||
[[Category:MoodleDocs]] | [[Category:MoodleDocs]] | ||
[[es:MoodleDocs:Filosofía de la documentación]] | |||
[[zh:文档的哲学]] | |||
Revisió de 03:58, 31 ago 2006
- Focus on Moodle Docs as the central Moodle knowledge-base
- Transfer content from Using Moodle forum discussions (e.g. answers to how-to questions, ideas/suggestions of ways of using a particular feature) to Moodle Docs
- Encourage newcomers to contribute to Moodle Docs
- "New users are ideal for writing system-level documentation aimed at new users. They have the point of view and experience with the current software at the system level rather than at the library level. The most common evidence of this is FAQ lists, in which issues repeatedly raised on mailing lists and chat sessions are answered." Source: Documentation issues in open source
- Encourage Using Moodle regulars to contribute to Moodle Docs by adding content in response to a question in the forums, then provide a link to the Moodle Docs page in the forum discussion
- Provide "See also" links in Moodle Docs to additional information in Using Moodle discussions e.g. Forums (though if the Using Moodle discussion leads to a conclusion/agreement then this should be transferred to MoodleDocs)
