- Tutorial or Documentation?

From: Douglas G. Danforth <"Douglas>
Date: Thu, 24 Mar 2005 19:00:36 -0500

----boundary-LibPST-iamunique-1214951723_-_-
Content-type: text/plain

Bob Walkden wrote:
>The trails can include a traditional table of contents, of course.
>Other types of trail could include:
>
> Prerequisites - for learning in a particular order
> Classifications - to group similar concepts
> Chronology - to show events happening in time order
> Structures - to show the parts of a structure
> Definition - to link related or similar definitions or terms
> Examples - to link the separate parts of a running example

I like this. I do agree with you.

What I am worried about is continuity where a single author remembers
what he said in chapter 2 and can refer to it in chapter 7 (say). With
multiple authors (and no Editor) this continuity is lost. The words
"fragmented", "jumbled", "disorganized", come to mind.

I find reading Microsoft documentation dry as sand and hope we can avoid
that style. We need "why" something is done in addition to "how" it is
done.

Now, how do we move forward?

-Doug

--- BlackBox
--- send subject HELP or UNSUBSCRIBE to blackbox{([at]})nowhere.xy



----boundary-LibPST-iamunique-1214951723_-_-
Content-type: application/rtf
Content-transfer-encoding: base64
Content-Disposition: attachment; filename="rtf-body.rtf"

e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcZnJvbXRleHQgXGRlZmYwe1xmb250dGJsDQp7XGYwXGZz
d2lzcyBBcmlhbDt9DQp7XGYxXGZtb2Rlcm4gQ291cmllciBOZXc7fQ0Ke1xmMlxmbmlsXGZjaGFy
c2V0MiBTeW1ib2w7fQ0Ke1xmM1xmbW9kZXJuXGZjaGFyc2V0MCBDb3VyaWVyIE5ldzt9fQ0Ke1xj
b2xvcnRibFxyZWQwXGdyZWVuMFxibHVlMDtccmVkMFxncmVlbjBcYmx1ZTI1NTt9DQpcdWMxXHBh
cmRccGxhaW5cZGVmdGFiMzYwIFxmMFxmczIwIEJvYiBXYWxrZGVuIHdyb3RlOlxwYXINCj5UaGUg
dHJhaWxzIGNhbiBpbmNsdWRlIGEgdHJhZGl0aW9uYWwgdGFibGUgb2YgY29udGVudHMsIG9mIGNv
dXJzZS5ccGFyDQo+T3RoZXIgdHlwZXMgb2YgdHJhaWwgY291bGQgaW5jbHVkZTpccGFyDQo+XHBh
cg0KPiAgICAgICBQcmVyZXF1aXNpdGVzIC0gZm9yIGxlYXJuaW5nIGluIGEgcGFydGljdWxhciBv
cmRlclxwYXINCj4gICAgICAgQ2xhc3NpZmljYXRpb25zIC0gdG8gZ3JvdXAgc2ltaWxhciBjb25j
ZXB0c1xwYXINCj4gICAgICAgQ2hyb25vbG9neSAtIHRvIHNob3cgZXZlbnRzIGhhcHBlbmluZyBp
biB0aW1lIG9yZGVyXHBhcg0KPiAgICAgICBTdHJ1Y3R1cmVzIC0gdG8gc2hvdyB0aGUgcGFydHMg
b2YgYSBzdHJ1Y3R1cmVccGFyDQo+ICAgICAgIERlZmluaXRpb24gLSB0byBsaW5rIHJlbGF0ZWQg
b3Igc2ltaWxhciBkZWZpbml0aW9ucyBvciB0ZXJtc1xwYXINCj4gICAgICAgRXhhbXBsZXMgLSB0
byBsaW5rIHRoZSBzZXBhcmF0ZSBwYXJ0cyBvZiBhIHJ1bm5pbmcgZXhhbXBsZVxwYXINClxwYXIN
CkkgbGlrZSB0aGlzLiAgSSBkbyBhZ3JlZSB3aXRoIHlvdS5ccGFyDQpccGFyDQpXaGF0IEkgYW0g
d29ycmllZCBhYm91dCBpcyBjb250aW51aXR5IHdoZXJlIGEgc2luZ2xlIGF1dGhvciByZW1lbWJl
cnMgXHBhcg0Kd2hhdCBoZSBzYWlkIGluIGNoYXB0ZXIgMiBhbmQgY2FuIHJlZmVyIHRvIGl0IGlu
IGNoYXB0ZXIgNyAoc2F5KS4gIFdpdGggXHBhcg0KbXVsdGlwbGUgYXV0aG9ycyAoYW5kIG5vIEVk
aXRvcikgdGhpcyBjb250aW51aXR5IGlzIGxvc3QuICBUaGUgd29yZHMgXHBhcg0KImZyYWdtZW50
ZWQiLCAianVtYmxlZCIsICJkaXNvcmdhbml6ZWQiLCBjb21lIHRvIG1pbmQuXHBhcg0KXHBhcg0K
SSBmaW5kIHJlYWRpbmcgTWljcm9zb2Z0IGRvY3VtZW50YXRpb24gZHJ5IGFzIHNhbmQgYW5kIGhv
cGUgd2UgY2FuIGF2b2lkIFxwYXINCnRoYXQgc3R5bGUuICBXZSBuZWVkICJ3aHkiIHNvbWV0aGlu
ZyBpcyBkb25lIGluIGFkZGl0aW9uIHRvICJob3ciIGl0IGlzIFxwYXINCmRvbmUuXHBhcg0KXHBh
cg0KTm93LCBob3cgZG8gd2UgbW92ZSBmb3J3YXJkP1xwYXINClxwYXINCi1Eb3VnXHBhcg0KXHBh
cg0KLS0tIEJsYWNrQm94XHBhcg0KLS0tIHNlbmQgc3ViamVjdCBIRUxQIG9yIFVOU1VCU0NSSUJF
IHRvIGJsYWNrYm94QG9iZXJvbi5jaFxwYXINClxwYXINCn0=


----boundary-LibPST-iamunique-1214951723_-_---
Received on Fri Mar 25 2005 - 01:00:36 UTC

This archive was generated by hypermail 2.3.0 : Thu Sep 26 2013 - 06:28:20 UTC