Forum .LRN Q&A: Re: Help With .LRN User Documentation

3: Re: Help With .LRN User Documentation (response to 1)

Posted by Bruce Spear on 10/30/03 01:22 AM

Thanks DeeDee! Right, I've started with the Sloan docs, am cutting them down in size, and developing a different emphasis. I am finding that our people ask a variety of questions which do not appear in those documents, that they will not read more than a couple of pages at a time, and that they demand different kinds of explanation. So, for the first few weeks, I'm basically editing and tailoring to local needs. I am hoping to gain some experience on these introductions to the technology so I can move on to advice on integrating the technology into the classroom and workflow or curriculum, beginning with such basic exercises as the minute paper. I am after a more qualitative understanding of the uses people my put this technology to, and by editing and rewriting the most basic instructions, trying to get closer to the user experience.
All the best,

Bruce

4: Re: Help With .LRN User Documentation (response to 3)

Posted by Matthias Melcher on 10/31/03 11:00 PM

I would like to help (more with feedback than with actual wording since I am no American).

Can the document be separated into
- a local/diff part containing site-specific data and recommendations, and
- a central/head part that can be copied, and ideally could be a basis for versioning and translation?

One recommendation that not everybody will like to copy, for instance, is to accept "all cookies" rather than "session cookies". Also, in Deidre's text, the humourous introduction is great for some audiences but not for all that we would like to target.

If the local end version could be derived by applying diffs to the newest respective head version, this would save much rewriting and adopting efforts.

Matthias