Talk:Quiz Quick Start

Jump to: navigation, search

Note: You are currently viewing documentation for Moodle 2.8. Up-to-date documentation for the latest stable version of Moodle may be available here: Quiz Quick Start.

--Steven Malikowski (talk) 02:30, 23 January 2016 (AWST) I’ve made a few changes to Moodle docs, but I just made a larger change. I hope it’s okay. I added this new section called “Quiz Quick Start.” I fully respect that everybody has their own way of helping people with technology. In the workshops I’ve given, new users want to make something simple first and then learn how to add more, which is why I made the Quiz Quick Start. It focuses on the absolute basics to quickly make a quiz and recommends that people explore other features after that, depending on their unique needs.

The current section called Building Quiz is similar and has a lot of good content, but some of it could be a bit much for people making their first quiz, like question banks, Question Sharer role, adding questions from a number of locations. The Quiz Quick Start suggests that people explore options like that after making a very simple quiz.

At the risk of spending too much time on the Quiz Quick Start, I also applied some current standards for writing online help, from organizations like Google and Microsoft. I’m looking forward to reading any comments about the Quick Start.

Looks like you have duplicated https://docs.moodle.org/30/en/Quiz_quick_guide, which already existed.--Tim Hunt (talk) 19:08, 25 January 2016 (AWST)


Quiz Quick Start

Thanks Steven for adding this useful page to the 2.8 documentation. Quick start guides are much appreciated, and I hope you don't mind if I use some of your images and good ideas in the Quiz Quick guide Tim refers to above, for the Moodle 3.0 documentation, because your page is very good! If you have any other ideas for Quick guides, feel free to add them to our up and coming list of Quick guides in Moodle 3.0: https://docs.moodle.org/30/en/Category:Quick_guide --Mary Cooch (talk) 23:08, 25 January 2016 (AWST)

Hi Mary, Thanks for your comment about my quick start, and it's fine to use my images. I'm happy to help. I'm curious about something that has probably come up before. Is there a style guide for Moodle docs? I found the guidelines for contributes. That's helpful, but it stops short of suggesting a consistent format or style in how documentation is written. I fully respect all the work that people have put into Moodle docs, but since I also want Moodle to be used more and respected more, I'd also like to make a gentle critique. The documentation can get a bit inconsistent, which means readers have to work harder to get the information they need. Wikipedia is a bit more consistent, but maybe it has more contributors and maybe editors. When I write documentation, for Moodle or others, I usually end up writing a style guide, by borrowing ideas from the online help written by Microsoft, Google, and others. As I mentioned, I suspect this topic has come up before, looking forward to learning more about it. --Steven Malikowski (talk) 23:41, 25 January 2016 (AWST)

Style guide

Yes Steven -it is a good point re the style guide. One thing about the wiki(s) is they have grown over the years with different volunteer contributors and we don't want to discourage volunteers by insisting they follow a particular style. We will sometimes, after a reasonable time, make changes to a new page or redirect it if really necessary, and we plan with the 3.0 documentation to make significant enhancements, starting with work in progress on the front page which as you can see https://docs.moodle.org/30/en/Main_page is different from the front pages of other documentation. Your point is one worth making in the Community sites forum, if you'd like to continue the discussion there. --Mary Cooch (talk) 15:26, 26 January 2016 (AWST)