How to link to Moodle documentation

How to link to Moodle documentation

deur Mary Cooch -
Getal antwoorde: 24
Prentjie van Documentation writers Prentjie van Moodle HQ Prentjie van Particularly helpful Moodlers Prentjie van Testers Prentjie van Translators

It's great to see so many people, especially Particularly Helpful Moodlers, linking to Moodle documentation when responding to queries glimlag I thought it might be worth reminding people of a couple of documentation-related things:

  • We've tried to make the documentation pages have appropriate names, so very often if you want to point someone in the direction of, say Conditional activities or Cohorts, the relevant docs page actually has that name. So all you need to do is type double square brackets either side of the name and it takes you straight there : linking to docs makes Text editor for example.
  • If you have to search the docs however, the link you come across via Google is quick to copy and paste but is often an older version (presumably because Moodle's faster than Googlegroot glimlag)  See here:

Googling Moodle cohorts

It links to Moodle 2.2, which might  be fine but might be out of date depending on the exact  information required.Since Moodle 2.0, every major release has got its own documentation version. So another useful thing to do is when you paste the link into forum posts, just take out the number (22 here) and then you will always get the latest version (such as: http://docs.moodle.org/en/Cohorts) Please help me spread the wordbak

Gemiddeld van beoordelings:Useful (8)
In antwoord op Mary Cooch

Re: How to link to Moodle documentation

deur Guillermo Madero -

Hello Mary,

So... Text editor works at the forums like in the wiki? (edit. Yes, it does!)

Yes, the endless cutting and writing of the version number glimlag

Gemiddeld van beoordelings: -
In antwoord op Mary Cooch

Re: How to link to Moodle documentation

deur dawn alderson -

Mary, hi

this is really helpful.  Makes a lot of senseglimlag

Cheers,

Dawn

Gemiddeld van beoordelings: -
In antwoord op Mary Cooch

Re: How to link to Moodle documentation

deur Séverin Terrier -
Prentjie van Documentation writers Prentjie van Particularly helpful Moodlers Prentjie van Testers Prentjie van Translators

Thanks Mary for this detailed explanation.

In fact, i know all of this since a long time, but don't often think/remember to use these brackets...

Séverin

Gemiddeld van beoordelings: -
In antwoord op Mary Cooch

Re: How to link to Moodle documentation

deur Derek Chirnside -

Helpful Mary.

But I very much dislike having hidden knowledge in a system like this.

  • What about a button in to do his for us like Wikpedia?  ie add a Type Docs Pagename here Button?
  • Or a tiny bit of help text at the bottom of the text entry window?

-Derek

Gemiddeld van beoordelings:Useful (1)
In antwoord op Mary Cooch

Re: How to link to Moodle documentation

deur Davo Smith -
Prentjie van Core developers Prentjie van Particularly helpful Moodlers Prentjie van Peer reviewers Prentjie van Plugin developers

What about dev docs?

((Migrating contrib code to 2.0)) = Migrating contrib code to 2.0

((Migrating_contrib_code_to_2.0)) = Migrating_contrib_code_to_2.0

((dev/Migrating_contrib_code_to_2.0)) = dev/Migrating_contrib_code_to_2.0

(I have no idea how you managed to put a double-square bracket into your original post without it becoming a link).

 

 

Gemiddeld van beoordelings: -
In antwoord op Davo Smith

Re: How to link to Moodle documentation

deur Mary Cooch -
Prentjie van Documentation writers Prentjie van Moodle HQ Prentjie van Particularly helpful Moodlers Prentjie van Testers Prentjie van Translators

Dev docs is not my domain so anything you can offer there is most welcome Davoglimlag And if you were referring to me and the double square bracket not linking, it's an image 

 

Gemiddeld van beoordelings: -
In antwoord op Mary Cooch

Re: How to link to Moodle documentation

deur ben reynolds -

Well, I just guessed about Windows downloads because I've been there so often, and I succeeded! Neat trick.

Agree with Derek that it wants to be a public trick. Typically, I use another tab/browser to go find the link. It's probably too much effort to catalog all the pages in one place so we know what they are, eh?

Gemiddeld van beoordelings: -
In antwoord op ben reynolds

Re: How to link to Moodle documentation

deur Derek Chirnside -

@Ben.

No it is not, it's easy.  It's a built in Mediawiki function.

But the list will be overwhelming.

Search via Google is quicker.

-Derek

Gemiddeld van beoordelings:Useful (2)
In antwoord op Derek Chirnside

Re: How to link to Moodle documentation

deur ben reynolds -

Hey Derek,

Yea, I figured what you said. Darn.

Also, I keep getting JSON errors when I read emails from this site.

Gemiddeld van beoordelings: -
In antwoord op Mary Cooch

Re: How to link to Moodle documentation

deur Itamar Tzadok -

Mary, with forum posts automatically parsing double brackets as docs links it may be useful to adjust the filter (I'm assuming this is done via a text filter) to recognize the <nowiki> tag and skip double brackets which are nowiki-ed. We have a problem explaining and posting working examples of double bracketed patterns such as the Database module's because the double brackets are filtered out. glimlag

Gemiddeld van beoordelings:Useful (2)
In antwoord op Itamar Tzadok

Re: How to link to Moodle documentation

deur Mary Cooch -
Prentjie van Documentation writers Prentjie van Moodle HQ Prentjie van Particularly helpful Moodlers Prentjie van Testers Prentjie van Translators

Itamar - perhaps you'd like to make a tracker issue for improving the custom filter used on moodle.org as you describe? glimlag

Gemiddeld van beoordelings: -
In antwoord op Mary Cooch

Re: How to link to Moodle documentation

deur Visvanath Ratnaweera -
Prentjie van Particularly helpful Moodlers Prentjie van Translators
Mary

Apart from what those gentlemen were saying, I get (non-html) mails like the one attached below. Not very helpful.
hartseer

So this is yet another highly non-geek idea. But let's not waste more time on them.
Aanhangsel doublebrackets.png
Gemiddeld van beoordelings: -
In antwoord op Visvanath Ratnaweera

Re: How to link to Moodle documentation

deur dawn alderson -

Visvanath, hi

hope you are good there.  To be fair, Mary has set out to be innovative here, so it seems to me-can't fault that eh.  Agree- what is that saying....oh yes-can't please them all-all of the time! gemeng  So, it seems a generic formula is a bit of an issue....well hey ho...........I have been thinking that maybe something permanent in the file picker might be an idea....you know a link that peeps can just click on to include in their post to help others........tricky I know.......have a geek T 'shirt here, have done since about the age of six..........but still struggle with a solution to this problem........essentially I think Mary was trying to address a major issue in Moodle-in that the user needs to rely on the docs for success......making that navigation easier- all round, appears to remain a challenge for all peinsend

cheers,

Dawn 

Gemiddeld van beoordelings:Useful (1)
In antwoord op dawn alderson

Re: How to link to Moodle documentation

deur Visvanath Ratnaweera -
Prentjie van Particularly helpful Moodlers Prentjie van Translators
Begum Dawn Alderson, Namasté

Oh, no! For heaven's sake, don't build the world around cynical geeks. The creative one you live in, is much nicer!

P.S. What happened to your Avatar? Nothing against bicycles, but that one looks like the quadrycle of Alfred Escher.
;-(
Gemiddeld van beoordelings: -
In antwoord op Visvanath Ratnaweera

Re: How to link to Moodle documentation

deur dawn alderson -

Mahodaya Visvanath Ratnaweera, namaskar.

Cynical geeks eh.....awwww now now glimlag

RE: Avatar, tis a sculpture by Ai Weiwei, the chap who taught himself about architecture and did the design for the stadium at the Beijing olympic games (2008) 'bird Nest'. I like the pic here because it is unusual to see circles squared in a square frame also.  

Not heard of A. Escher, have heard of M. Escher, was inspired by geometry and logic of space...I remember seeing some work with tesselations, for example.

Bahut Bahut knipoog

Dawn   

Gemiddeld van beoordelings: -
In antwoord op dawn alderson

Re: How to link to Moodle documentation

deur Visvanath Ratnaweera -
Prentjie van Particularly helpful Moodlers Prentjie van Translators
Dawn

Talking of Ai Weiwei, this is how an icon is being wasted: http://www.bbc.com/news/world-asia-pacific-26613538.

Coming back to our original topic of cynical geeks, here's another suffering: "How to stop Moodle hijacking my hyperlink?" https://moodle.org/mod/forum/discuss.php?d=256371.
Gemiddeld van beoordelings:Useful (1)
In antwoord op Visvanath Ratnaweera

Re: How to link to Moodle documentation

deur dawn alderson -

Visvanath, hi

thanks for that link...will look at it more closely later today. 

I must say, there is something most interesting about that code in the thread you included-pattern strings can be intriguing, yes I recognise the detail must get a bit nauseating at times, but the end goal, when achived must surely be satisfying.

Have you thought about having a crypto party? Jazz up things a bit Ja Something to be said about random numbers eh...

not sure if you will be able to pick up on this link:

www.bbc.co.uk/programmes/b03xzyy5   (BBC Radio 4-Crypto wars) There is a three day listening period left on it.

glimlag

Dawn

 

 

 

Gemiddeld van beoordelings: -
In antwoord op dawn alderson

Re: How to link to Moodle documentation

deur Visvanath Ratnaweera -
Prentjie van Particularly helpful Moodlers Prentjie van Translators
Crypto wars? While we geeks are polishing our algorithms the "state" comes through with strong arm tactics (or through moles or Mata Haris or ...) We were there: https://moodle.org/mod/forum/discuss.php?d=234108#p1105739.

N.B. Where are we? What was the topic? Why does it say, "How to link to Moodle documentation"?
;-P
Gemiddeld van beoordelings: -
In antwoord op Visvanath Ratnaweera

Re: How to link to Moodle documentation

deur Robert Brenstein -
May be a fix can be something a simple as requiring a keyword, for example: [ [ doclink:Dataform module ] ]

This would allow to the filter to leave other uses of square brackets unaffected and also make this more meaningful in emails until the filter learns how to make the replacement in emails as well, if that ever happens.
Gemiddeld van beoordelings:Useful (2)