New Moodle docs proposal | Stack Overflow

New Moodle docs proposal | Stack Overflow

by Derek Chirnside -
Number of replies: 3
In reply to Derek Chirnside

Re: New Moodle docs proposal | Stack Overflow

by Richard Oelmann -
Picture of Core developers Picture of Plugin developers Picture of Testers

Hmm - from their page:

It had to be based on assumptions, not need
It was usually written once, often by someone not even using the technology, so it was a guess at what to focus on.

Well, Moodle docs are a wiki, so they are not (or dont have to be) written once only and usually are written by someone either using or who developed it

It didn't prioritize good examples
People learn best when they can see things demonstrated in actual code.

There are plenty of code examples throughout the developer docs at least.

Personally, I'd prefer people to focus on improving the existing docs by contributing, rather than start a new set of docs on an external system somewhere - but that is my own view, and anyone is free to create supporting docs for Moodle where they want to, I just would prefer to see the effort concentrated rather than spread thinly across anyone's current favourite system.

Average of ratings: Very cool (3)
In reply to Derek Chirnside

Re: New Moodle docs proposal | Stack Overflow

by Howard Miller -
Picture of Core developers Picture of Documentation writers Picture of Particularly helpful Moodlers Picture of Peer reviewers Picture of Plugin developers

"Together, we can do for Documentation what we did for Q&A"

I sincerely hope not. Create a place for people to be pedantic and petty?

I cannot stand Stack Exchange. I may have mentioned this before. Heaven for geeks and nerds in the most pejorative sense tongueout

Average of ratings: Very cool (1)