Note: You are currently viewing documentation for Moodle 1.9. Up-to-date documentation for the latest stable version is available here: Main Page/draft1.
- 1 Comment on overall MoodleDocs2 look
- 2 Comments about format
- 3 Feedback
- 4 Discussions
- 5 Main page links
- 6 Fantastic Stuff
- 7 Add links to international versions (es,...)
- 8 Headline text ??
- 9 Upload Flash
- 10 Image on the front page
- 11 Amazing!
- 12 Disorienting
- 13 need faq link
- 14 i see
- 15 ending a sentence in "to"
- 16 Hooray 1.9
- 17 Underlined links?
- 18 noinclude
- 19 Example 1
- 20 Example2
- 21 Example3
Comment on overall MoodleDocs2 look
Comments about format
Welcome to Moodle Docs, the documentation for Moodle that accepts everyone's contributions.
- Wonder if we could give a clue about the language in the next sentence by
"In this English (British/Austrailian) version, officially launched on 26 January 2006,.."
--chris collman 07:22, 28 October 2008 (CDT)
I think I am changing my mind again about the format of this page. Admin and Developer documentation pages are very different than the teacher documentation page. I don't like the index idea below. I would like a complete overhaul of the teacher documentation page to match the other two formats. --chris collman 23:06, 23 August 2006 (CDT)
Here is what I (--chris collman) would suggest on this page, my version looks ugly but :)
- About Moodle - not sure where ? Special:Categories ?
- Teacher document index
- | Administrator document index
- |Developer document index
Featured Pages for new and old
- Teachers - Teacher page, The Good Teacher and Groups FAQ link etc
- Administrators -Administrator page, Upgrading to Moodle 1.6 and LDAP authentication, link
- Student - | Student document index, Student_tutorials, link
- Developers: 1.6 theme upgrade and the XML database schema
- Everyone: Guidelines for contributors
Just my two cents worth to make it a little bit more friendly to new user. --chris collman 00:34, 31 July 2006 (WST)
- This did not have a heading, my stuff and assume I failed to put one in. Sorry.--chris collman 15:28, 30 July 2010 (UTC)
You make it very difficult to get started with this thing! Now you would think the Main Page would be a good place to start. So on the main page I click "About Moodle", which takes me to a page, which in turn talks about PHP and MySQL, but still nothing really about how to get started. So I try clicking on "moodle with us". Now I see a list of which, "Using Moodle" seems like the most obvious choice. This whisks me off to another page where I click on "WELCOME! Are you new? Confused? Please start here!" Finally, I think, we're getting somewhere. Oops, no! Yet another page that tells me nothing. Instead of a detailed introduction, I am pointed to "documentation for Moodle", which I dutifuly click. Where am I now? Right back at the same Home Page I started from; only more frustrated and none the wiser.
Very interesting wiki site!... Thanx! --HarryRens 15 October 2005 23:42 (WST)
"that everyone may contribute to." is bad English. Better to write "to which everyone may contribute."--N Hansen 20:16, 17 April 2006 (WST)
I have to agree with the first writer who finds Moodle difficult to get started with; I followed much the same sequence of links as they did. It takes quite a bit of Moodling to find a simple description of what Moodle does and it philosophy. It's great to find the docs as a wiki though and to be able to comment like this. --Matthew Fairtlough 07:58, 16 October 2006 (CDT)
As it is written, “It’s easy to edit pages”. Actually, from the relatively intelligent newbie perspective, the editing process, et al, can be quite confusing and often intimidating. I suggest adding a disclaimer as, “once you get used to it” (it may be easy for some, and not so easy for others- for numerous reasons) or just saying “relatively easy” . One should not get discouraged by the long page that follows when one clicks on the “edit” link. Then, as the text continues with “have a play in our sandbox”, the sandbox link leads to a less intimidating exploration. Perhaps this also will address the issues presented by ”No Sandbox” here’ advocates. --LarryF-Lawrence Fish 06:09 29 July 2010 (EST)
- In 2006, I did not know anything about either a wiki or a Moodle. "It is easy to change a page" is a more accurate statement. You may notice by the 3 to 4 reverts that are done a week on these pages, that they are usually the results of people changing the page and not editing the page:) Editing anything is not easy, whether it be Word, Excel or a MediaWiki, so you point is well taken. I like your more direct nudge to the sandbox. A few of us have spent a little bit of time with the help pages, maybe that link should be changed to MoodleDoc help, because it looks like it is Moodle help. The goal of this page is to keep it lean but perhaps we have over achieved the goal:) Thanks for comments, change is OK --chris collman 15:46, 30 July 2010 (UTC)
There is very little discussion about MoodleDocs that I can find. I know there used to be a whole course at moodle.org dedicated to discussions about documentation, but that appears to have vanished. Is there a substitute for it? Where can I ask questions about this wiki? For example: How do I change my username from Delius to Gustav? --Gustav Delius 09:41, 26 January 2006 (WST)
- Thanks for your comments. Please note that Martin Dougiamas will make an announcement about the documentation very soon. Re. changing your username, the easiest way to achieve this is to re-register with username Gustav then add a redirect
to your old user page. -- Helen Foster 17:59, 26 January 2006 (WST)
- Thanks Helen. I have done that. My username looks more friendly now. --Gustav Delius 18:10, 26 January 2006 (WST)
Can we have a link to Student Tutorials under About Moodle? It seems that the main page only offers help for teachers and administrators, not students..
I wonder if someone were to delete the negative comments / weaknesses or Moodle (by intent or by accident) would that not be a disadvantage to allow these Edits? Forums would serve the purpose better no? [User:vkermani]
Its all muddled up. As the first user mentioned..I went round and round looking for how to install...(so many ways but no proper info) waste of a precious day. [User:vkermani]
I'd strongly recommend adding the panel of links from About Moodle to the Main Page as well - they're incredibly important. I'm talking about the "Introduction | Background | Philosophy | License | Features | Release Notes | Future | Credits" links. --Dan
- Hi Dan, thanks for your recommendation. The main page content definitely needs a re-think. -- Helen 02:31, 27 January 2006 (WST)
I would like to see a reference to the Moodle Community and the collaborative aspects of learning about both Moodle as a product and as a process. I am not sure where would be the best place to anchor that page. --mburnet
Just a brief thought re: "featured pages" and "Teaching Don'ts" link--could we also add "Teaching Dos" so that the focus is balanced and a little more positive for newbies stumbling into this page for the first time? --Lesli Smith
- Hi Lesli, as requested, Teaching Do's is now a featured page. Apologies for the delay. --Helen Foster 04:31, 1 April 2006 (WST)
Just wanted to pop in quickly and say a huge thankyou to Helen for this fantastic resource.
Your work here is looking fantastic. So much for adding your time and expertise to this community. I know what it is like to juggle many hats. If you ever need a hand you need only ask :)
Looking forward to seeing this integrated into 1.6.
- I second that. Great job, Helen! :-) --Art Lader 01:56, 23 February 2006 (WST)
- Thanks guys, though it's everyone's contributions that will make Moodle Docs into a great resource! --Helen Foster 03:57, 23 February 2006 (WST)
I'm a little late, but I also want to thank you so much for this wonderful resource. :-D --Lesli
Since https://docs.moodle.org is the main site for Moodle Documentation, there must be links to the different international versions, such as the Spanish one: https://docs.moodle.org/es . Maybe something similar to the Wikipedia home page: http://www.wikipedia.org . If not, just links to international versions in the main English page.
- Hi David, you're very welcome to add inter-language links - please check the guidelines for contributors for more details. --Helen Foster 05:54, 18 February 2006 (WST)
- As long as this page is locked I can not add link to Czech version. --David Mudrak 04:20, 10 July 2006 (WST)
--Jose A. Heredia 08:05, 14 August 2006 (WST)
Hi, Helen, please add link to Slovak version. Thanks. Miroslav Fikar
- Hi Miroslav, I've added the link, thanks. --Helen Foster 02:18, 12 September 2006 (CDT)
- Korean link added, thanks. --Helen Foster 22:37, 28 May 2011 (WST)
Several more international versions of this page exist:
Erik Pedersen 05:30, 13 November 2007 (CST)
- Erik, apologies for missing your comment before now. I've added the eu link. Generally inter-language links are added as/when people contributing to the language request them. --Helen Foster 22:37, 28 May 2011 (WST)
Headline text ??
Ver tambien la web donde podreis encontrar un Video tutorial en el cual se describe, se ve y se oye como instalar el PHP-NUKE, que aunque no es igual que el Moodle, si se instala y se configura de la misma manera, este video tutorial podeis encontrarlo en el siguiente vinculo 
Hi Jose, I don't think this belongs in the english page. --chris collman 21:54, 23 August 2006 (CDT)
Is it possible to upload Flash files? I tried to do so via the same interface we use for uploading images, but had no luck. --Art Lader 19:10, 22 February 2006 (WST)
- Hi Art, sorry it's not possible to upload Flash files for security reasons. Please could you explain what you would like to do, and perhaps send me a sample file, then I'll investigate alternative options. --Helen Foster 03:53, 23 February 2006 (WST)
- That is not a probelm, Helen. I have upgraded to SnagIt 8.0 and can add tooltips to screen captures. Just wanted to see if that improved the documentation. No big deal, though. --Art Lader 06:28, 23 February 2006 (WST)
Image on the front page
Can we have a nice image somewhere on the front page, something documenty like books maybe? Just to make the home page stand out a little from the subpages. Martin Dougiamas 22:26, 14 April 2006 (WST)
- How about some free stock photography? I tend to use http://www.sxc.hu/ --Darren Smith 23:00, 14 April 2006 (WST)
You guys never cease to amaze me.
When I first came to this page, I had no idea that I was looking at a wiki! It would be great to go ahead and put the word 'wiki' somewhere on the page, and maybe on pages linking to this one, so that people know what they're getting into. I expected this page to be the source for official documentation, and so I was very disappointed to click 'Teacher Documentation' and get little more than a quick-start guide. Inside the 'Teacher Documentation' page, though, there is a link to a page which has PDF's of what I would personally call documentation. I could be projecting, but I think others also expect 'documents' rather than 'wikis' when looking for 'documentation'.
- The above comment caused me to really look at the Teacher Documentation page, and edit it more than once. I would like to see the Teacher link on the left of this page go to a page that looked similar to the Administrator or Developer link pages. This would help new and old users find things in MoodleDocs quicker. I thank the above author for the quick start comment which encouraged me to make some changes in the Teacher Documentation page until we make a new task orientated page for teachers.
- I disagree about the wiki comment. The point is not that it is a wiki, the point is that the document did not meet above author's expectations. I am in mild agreement on that point. With good humor I note: when I first looked at MoodleDocs, "wiki" would be an absolutely meaningless word to me and no help at all. Hey, I've been a new user since C/PM days. :)--chris collman 22:58, 23 August 2006 (CDT)
can we please have a link to the faq's from the main page? Makes no sense not to!
also would like to see a link for STUDENT as there is with teacher and admin and so on- after all what is all this about??D.I. von Briesen 14:51, 27 June 2007 (CDT)
Wow this completely takes down what I wanted to develope... Maybe I'll do it anyway for fun.
--Yogesh Kulkarni 00:29, 17 May 2007 (CDT)
Nice to see and find my name here.
Its gr8. --Yogesh Kulkarni 07:17, 21 June 2007 (CDT)
ending a sentence in "to"
There is absolutely nothing wrong with ending a sentence with a preposition, like "to." The idea that that is wrong came from some misguided grammarians in the beginning of the twentieth century. They felt that Latin was a perfect language, and so they artificially tried to adopt some of its rules; like don't end a sentence with a preposition, or don't split an infinitive. However, English is a Germanic language, not a Romance language. It's perfectly natural in English to casually insert an adverb in the middle of an infinitive, or to end a sentence with a preposition.
- Hi Eric, I appreciate your point. In matters of styles, I try not to say things are wrong. As you point out, it is a "casual" form. On the opening page that is read by many "non-native speakers" of an English dialect, I thought it would be better not to end the sentence in to. (attempt at akward humor there :)
- Glad to find another person with strong opinions about those Romance logical perfectionists. My viewpoint on the use of "to" has not been accepted by the people who control the "Main page". --chris collman 04:50, 14 November 2007 (CST)
I think "including the documentation of new features in Moodle 1.9" that jumps to the category index page is a bit much. Perhaps a link to the Release_Notes#Moodle_1.9 section in the release notes. Or, placing a release notes section link at the top of the category index would be an alternative. A new page to chat up just 1.9 seems overkill. Just a thought--chris collman 08:27, 6 March 2008 (CST)
Maybe this was discussed previously, but: in my opinion the text would be easier to read if the links were not underlined, but only "hover-underlined" as in Wikipedia. --Samuli Karevaara 00:23, 9 September 2008 (CDT)
- Either Eloy is really quick, or I am missing something? I am using Firefox 3. and looked at the link I put in the section above this one. It is in blue. Then when my mouse goes over it it underlines and presents a title (alternative text). Could be browser based, one of those CSS things. Best --chris collman 17:21, 10 September 2008 (CDT)
- Now it's hover-underlined for me in Firefox too. Chrome still shows it as "always-underlined". But it's not just the browser issue, as Finnish Moodle Docs works as hover-underlined in Chrome too, plus I think I did try with several browsers. Anyhoo, probably the hover-based thing is the target, and most likely that setting will take place any hour now :-) i was also wondering if it's a user profile setting somewhere. --Samuli Karevaara 21:55, 10 September 2008 (CDT)
- Well, I must confess I have done nothing. Working "hover-underlined" here under FF and Safari since ages ago. No user preference about that AFAIK. Ciao :-) Eloy Lafuente (stronk7) 15:42, 14 September 2008 (CDT)
- BTW, just noticed that it does change from hover to static underline when I log in. Not logged in = fine, logged in = the static underlining. Investigating... --Samuli Karevaara 04:42, 17 September 2008 (CDT)
- Ah, just found one new setting ("Underline links") under User preferences->Misc ! It allows "never", "always" and "browser default". Perhaps is it? --Eloy Lafuente (stronk7) 05:02, 17 September 2008 (CDT)
- Sweet! Thanks! That was it. I wonder how come I didn't stumble upon it on my adventures in the preferencesland, thanks again! --Samuli Karevaara 23:38, 20 September 2008 (CDT)
It looks to me like noinclude is not working on this wiki, e.g., for the Template:About Moodle, there are some categories. These should not be shown on pages on which the template is substituted or transcluded. They are for categorising the template itself. But
Welcome to Moodle Docs. This is the documentation for Moodle that anyone in our community may edit. In this English version, officially launched in January 2006, we are currently working on 2,185 articles, including the documentation of new features in Moodle 1.9.
Please help us expand our frequently asked questions - see Category:FAQ
Wonder if it could be laid out with 6 cells like Front Page Moodle.org. Add