-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
On 6/18/12 3:03 PM, Peter Krautzberger wrote:
> Thanks @Marc -- and for the subtle hint re our docs ;)
LOL, the docs are actually very comprehensive, but for people who
learn by doing (yes, there are some who would suggest that an entire
gender of homo sapiens is incapable of reading all the instructions
first - "I am a man, But I can change, If I have to, I guess....")
or are willing to put in some time for a quick fix but don't have
several hours to work through the docs, RTFM is not an appropriate
response ;-) [if it ever is, though one's patience may be tried.)
A colleague and I tried to do a case analysis with some Moodle docs
and I thought it was helpful. We took a couple of the most common
configurations and tried to step through how they worked, why they
worked that way, and how we did the configuration. In other words, we
did enough to demonstrate the process behind the configuration and
illustrated a common configuration that we could expect might produce
possible confusion.
The kitchen sink common configs are GREAT solutions, but for a user
who needs to change the tokens (not unusual), he needs to understand
how to effect the default where he is using the CDN, and the possible
tradeoffs between using the common config, and using his own full
config. To manage that he would eventually have worked through at
least a dozen doc pages (at least twice, lol)
While I don't know that that would be an unreasonable burden (it would
certainly be less trouble than the constant hassles with the Moodle
TeX filter, lol) there is of course a trade off in facilitating the
use of such tools; after all, the whole idea is to make this
technology available :-)
Wearing my designing hat I have suggested that the best way to develop
functional user documentation is to actually observe persons with
almost no background try to work through deployment of a technology
uing the interface or docs. While David spends an incredible amount of
time "in the trenches" as do others in the project, we so often see
web interfaces and documentation that are in fact grossly inaccurate,
inconsistent with the supposedly supported product, etc., such that a
user has to wonder if anyone has actually had to use the docs, lol.
While MathJax is far ahead of such Maroons, such an "explore" might
address the kinds of question we saw here.
And now, I will shut up, as I noticed that someone got the hint and
the room is running out of oxygen ;-)
Thanks folks!
iQEcBAEBAgAGBQJP38jHAAoJEMCi9wxDaNqE4IQH/3kVKVHG2dtLMb2z4RXTXFnx
O0MSRzsItVmTf+FQlLZzXgc1I8vaXjw2+TeMeI5vyYEsZTrk7BbXFLcqAH0BJp+B
SrAaMCJ1hqSJ6eYRpf8Z74T79In7b8qw+hfiVoW/hz+oTrns2kws8VoXSVQp9N2b
kxG+SUX3EYVfne627nL8byVm3Kwc1kJpexYegoa9csv01b2JKAntBz72Mp4I02/b
ra5o6IN2dipB9EKXjyS/hTDCXFDqILqhHJKzP/lYZaiCdykkl8Wb9zkDoQnX5Z52
XBPCmbm1NHbPb1UF+G3gF7Nd6ZKeRVvIclIlefeQOj6dsCXoNwy5BK2hs7rMU2Q=
=YZCY
-----END PGP SIGNATURE-----