Re: Documentation and pointers

From: [at]} <Wojtek>
Date: Sun, 3 Aug 2003 17:32:29 -0400 (EDT)

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

On Sun, 3 Aug 2003, Bob Walkden wrote:

> Compare this with the
> BB/CP format where the document opens with the definition, which can be
> quite intimidating, and rarely provides the same quality of overview or
> detail. This, I should think, is the result of commerical pressures that do
> not apply in the university. I am subject to similar pressures, and my own
> standard of documentation suffers.

Bob, but they do provide the "Case study..." book, seven chapters in
total. Just look at Help->Content. What is wrong with this? Is it not
the kind of the overview that you are talking about?

I am myself not a big fan of the module-by-module documentation,
and I must admit I do not like the "Case study..." either, but let's
try be more specific. If we all seem to agree the BB docu is not perfect,
where is the imperfection? What's missing in their "Case study" and how
it could be improved?

Wojtek


--------------------------------------------

To unsubscribe from this mailing list, send a message containing the word "unsubscribe" to:
   blackbox-request{([at]})nowhere.xy

To get a list of valid e-mail commands and instructions on their usage, send a message containing the word "help" to the above address.

Send any problem reports or questions related to this email list to the list owner at
   owner-blackbox{([at]})nowhere.xy

Current posting policy:

a) To post you should use the same address by which you are subscribed to the mailing list. That way, the list server will recognize you as subscriber and forward your posting immediately, without creating any overhead.

b) If, for some reason, you cannot post from the address, by which you are subscribed, your message will be moderated to avoid spam. Please understand that moderation will often cause some delay, in particular over weekends or holydays.



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

e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcZnJvbXRleHQgXGRlZmYwe1xmb250dGJsDQp7XGYwXGZz
d2lzcyBBcmlhbDt9DQp7XGYxXGZtb2Rlcm4gQ291cmllciBOZXc7fQ0Ke1xmMlxmbmlsXGZjaGFy
c2V0MiBTeW1ib2w7fQ0Ke1xmM1xmbW9kZXJuXGZjaGFyc2V0MCBDb3VyaWVyIE5ldzt9fQ0Ke1xj
b2xvcnRibFxyZWQwXGdyZWVuMFxibHVlMDtccmVkMFxncmVlbjBcYmx1ZTI1NTt9DQpcdWMxXHBh
cmRccGxhaW5cZGVmdGFiMzYwIFxmMFxmczIwIE9uIFN1biwgMyBBdWcgMjAwMywgQm9iIFdhbGtk
ZW4gd3JvdGU6XHBhcg0KXHBhcg0KPiBDb21wYXJlIHRoaXMgd2l0aCB0aGVccGFyDQo+IEJCL0NQ
IGZvcm1hdCB3aGVyZSB0aGUgZG9jdW1lbnQgb3BlbnMgd2l0aCB0aGUgZGVmaW5pdGlvbiwgd2hp
Y2ggY2FuIGJlXHBhcg0KPiBxdWl0ZSBpbnRpbWlkYXRpbmcsIGFuZCByYXJlbHkgcHJvdmlkZXMg
dGhlIHNhbWUgcXVhbGl0eSBvZiBvdmVydmlldyBvclxwYXINCj4gZGV0YWlsLiBUaGlzLCBJIHNo
b3VsZCB0aGluaywgaXMgdGhlIHJlc3VsdCBvZiBjb21tZXJpY2FsIHByZXNzdXJlcyB0aGF0IGRv
XHBhcg0KPiBub3QgYXBwbHkgaW4gdGhlIHVuaXZlcnNpdHkuIEkgYW0gc3ViamVjdCB0byBzaW1p
bGFyIHByZXNzdXJlcywgYW5kIG15IG93blxwYXINCj4gc3RhbmRhcmQgb2YgZG9jdW1lbnRhdGlv
biBzdWZmZXJzLlxwYXINClxwYXINCkJvYiwgYnV0IHRoZXkgZG8gcHJvdmlkZSB0aGUgIkNhc2Ug
c3R1ZHkuLi4iIGJvb2ssIHNldmVuIGNoYXB0ZXJzIGluXHBhcg0KdG90YWwuIEp1c3QgbG9vayBh
dCBIZWxwLT5Db250ZW50LiBXaGF0IGlzIHdyb25nIHdpdGggdGhpcz8gSXMgaXQgbm90XHBhcg0K
dGhlIGtpbmQgb2YgdGhlIG92ZXJ2aWV3IHRoYXQgeW91IGFyZSB0YWxraW5nIGFib3V0P1xwYXIN
ClxwYXINCkkgYW0gbXlzZWxmIG5vdCBhIGJpZyBmYW4gb2YgdGhlIG1vZHVsZS1ieS1tb2R1bGUg
ZG9jdW1lbnRhdGlvbixccGFyDQphbmQgSSBtdXN0IGFkbWl0IEkgZG8gbm90IGxpa2UgdGhlICJD
YXNlIHN0dWR5Li4uIiBlaXRoZXIsIGJ1dCBsZXQnc1xwYXINCnRyeSBiZSBtb3JlIHNwZWNpZmlj
LiBJZiB3ZSBhbGwgc2VlbSB0byBhZ3JlZSB0aGUgQkIgZG9jdSBpcyBub3QgcGVyZmVjdCxccGFy
DQp3aGVyZSBpcyB0aGUgaW1wZXJmZWN0aW9uPyBXaGF0J3MgbWlzc2luZyBpbiB0aGVpciAiQ2Fz
ZSBzdHVkeSIgYW5kIGhvd1xwYXINCml0IGNvdWxkIGJlIGltcHJvdmVkP1xwYXINClxwYXINCldv
anRla1xwYXINClxwYXINClxwYXINCi0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t
LS0tLS0tLS0tXHBhcg0KXHBhcg0KVG8gdW5zdWJzY3JpYmUgZnJvbSB0aGlzIG1haWxpbmcgbGlz
dCwgc2VuZCBhIG1lc3NhZ2UgY29udGFpbmluZyB0aGUgd29yZCAidW5zdWJzY3JpYmUiIHRvOlxw
YXINCiAgIGJsYWNrYm94LXJlcXVlc3RAb2Jlcm9uLmNoXHBhcg0KXHBhcg0KVG8gZ2V0IGEgbGlz
dCBvZiB2YWxpZCBlLW1haWwgY29tbWFuZHMgYW5kIGluc3RydWN0aW9ucyBvbiB0aGVpciB1c2Fn
ZSwgc2VuZCBhIG1lc3NhZ2UgY29udGFpbmluZyB0aGUgd29yZCAiaGVscCIgdG8gdGhlIGFib3Zl
IGFkZHJlc3MuXHBhcg0KXHBhcg0KU2VuZCBhbnkgcHJvYmxlbSByZXBvcnRzIG9yIHF1ZXN0aW9u
cyByZWxhdGVkIHRvIHRoaXMgZW1haWwgbGlzdCB0byB0aGUgbGlzdCBvd25lciBhdFxwYXINCiAg
IG93bmVyLWJsYWNrYm94QG9iZXJvbi5jaFxwYXINClxwYXINCkN1cnJlbnQgcG9zdGluZyBwb2xp
Y3k6XHBhcg0KXHBhcg0KYSkgVG8gcG9zdCB5b3Ugc2hvdWxkIHVzZSB0aGUgc2FtZSBhZGRyZXNz
IGJ5IHdoaWNoIHlvdSBhcmUgc3Vic2NyaWJlZCB0byB0aGUgbWFpbGluZyBsaXN0LiBUaGF0IHdh
eSwgdGhlIGxpc3Qgc2VydmVyIHdpbGwgcmVjb2duaXplIHlvdSBhcyBzdWJzY3JpYmVyIGFuZCBm
b3J3YXJkIHlvdXIgcG9zdGluZyBpbW1lZGlhdGVseSwgd2l0aG91dCBjcmVhdGluZyBhbnkgb3Zl
cmhlYWQuXHBhcg0KXHBhcg0KYikgSWYsIGZvciBzb21lIHJlYXNvbiwgeW91IGNhbm5vdCBwb3N0
IGZyb20gdGhlIGFkZHJlc3MsIGJ5IHdoaWNoIHlvdSBhcmUgc3Vic2NyaWJlZCwgeW91ciBtZXNz
YWdlIHdpbGwgYmUgbW9kZXJhdGVkIHRvIGF2b2lkIHNwYW0uIFBsZWFzZSB1bmRlcnN0YW5kIHRo
YXQgbW9kZXJhdGlvbiB3aWxsIG9mdGVuIGNhdXNlIHNvbWUgZGVsYXksIGluIHBhcnRpY3VsYXIg
b3ZlciB3ZWVrZW5kcyBvciBob2x5ZGF5cy5ccGFyDQpccGFyDQp9


----boundary-LibPST-iamunique-1133836881_-_---
Received on Sun Aug 03 2003 - 23:32:29 UTC