Re: Documentation and pointers

From: [at]} <ftkachov{>
Date: Sun, 3 Aug 2003 03:28:34 +0400 (MSK DST)

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

> author of the document obviously had a full understanding and knowledge
> of all the parts of the Blackbox framework and hence either forgot or
> purposefully did not define those concepts within the TextModels
> documentation (for example "text setter").

but this is the usual problem with e.g. all scientific texts:
it is extremely difficult for the author to write from a perspective
of someone who knows nothing about the subject.
That's why the original scientific papers are incomprehensible.

> The use of "one place only" and "multiple descriptions" are at variance

again, this is the usual problems of any complex design -- is why
there is so much ..ppy software out there.

I'd rather choose imperfectly documented great software.

Wojtek, there was nothing of a reprimand in any of my messages,
and I am in no position to make one; I'm just looking at it all
clinically. There is nothing in the situation that would go against
the laws of nature.

> There must be some way that the Blackbox user community can help Ominc
> improve its documentation.

That's exactly the point. Let's shift the emphasis to what we can do
as a community.

Cheers
Fyodor
--------------------------------------------

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-170398181_-_-
Content-type: application/rtf
Content-transfer-encoding: base64
Content-Disposition: attachment; filename="rtf-body.rtf"

e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcZnJvbXRleHQgXGRlZmYwe1xmb250dGJsDQp7XGYwXGZz
d2lzcyBBcmlhbDt9DQp7XGYxXGZtb2Rlcm4gQ291cmllciBOZXc7fQ0Ke1xmMlxmbmlsXGZjaGFy
c2V0MiBTeW1ib2w7fQ0Ke1xmM1xmbW9kZXJuXGZjaGFyc2V0MCBDb3VyaWVyIE5ldzt9fQ0Ke1xj
b2xvcnRibFxyZWQwXGdyZWVuMFxibHVlMDtccmVkMFxncmVlbjBcYmx1ZTI1NTt9DQpcdWMxXHBh
cmRccGxhaW5cZGVmdGFiMzYwIFxmMFxmczIwID4gYXV0aG9yIG9mIHRoZSBkb2N1bWVudCBvYnZp
b3VzbHkgaGFkIGEgZnVsbCB1bmRlcnN0YW5kaW5nIGFuZCBrbm93bGVkZ2UgXHBhcg0KPiBvZiBh
bGwgdGhlIHBhcnRzIG9mIHRoZSBCbGFja2JveCBmcmFtZXdvcmsgYW5kIGhlbmNlIGVpdGhlciBm
b3Jnb3Qgb3IgXHBhcg0KPiBwdXJwb3NlZnVsbHkgZGlkIG5vdCBkZWZpbmUgdGhvc2UgY29uY2Vw
dHMgd2l0aGluIHRoZSBUZXh0TW9kZWxzIFxwYXINCj4gZG9jdW1lbnRhdGlvbiAoZm9yIGV4YW1w
bGUgInRleHQgc2V0dGVyIikuXHBhcg0KXHBhcg0KYnV0IHRoaXMgaXMgdGhlIHVzdWFsIHByb2Js
ZW0gd2l0aCBlLmcuIGFsbCBzY2llbnRpZmljIHRleHRzOlxwYXINCml0IGlzIGV4dHJlbWVseSBk
aWZmaWN1bHQgZm9yIHRoZSBhdXRob3IgdG8gd3JpdGUgZnJvbSBhIHBlcnNwZWN0aXZlXHBhcg0K
b2Ygc29tZW9uZSB3aG8ga25vd3Mgbm90aGluZyBhYm91dCB0aGUgc3ViamVjdC5ccGFyDQpUaGF0
J3Mgd2h5IHRoZSBvcmlnaW5hbCBzY2llbnRpZmljIHBhcGVycyBhcmUgaW5jb21wcmVoZW5zaWJs
ZS5ccGFyDQpccGFyDQo+IFRoZSB1c2Ugb2YgIm9uZSBwbGFjZSBvbmx5IiBhbmQgIm11bHRpcGxl
IGRlc2NyaXB0aW9ucyIgYXJlIGF0IHZhcmlhbmNlIFxwYXINClxwYXINCmFnYWluLCB0aGlzIGlz
IHRoZSB1c3VhbCBwcm9ibGVtcyBvZiBhbnkgY29tcGxleCBkZXNpZ24gLS0gaXMgd2h5XHBhcg0K
dGhlcmUgaXMgc28gbXVjaCAuLnBweSBzb2Z0d2FyZSBvdXQgdGhlcmUuXHBhcg0KXHBhcg0KSSdk
IHJhdGhlciBjaG9vc2UgaW1wZXJmZWN0bHkgZG9jdW1lbnRlZCBncmVhdCBzb2Z0d2FyZS5ccGFy
DQpccGFyDQpXb2p0ZWssIHRoZXJlIHdhcyBub3RoaW5nIG9mIGEgcmVwcmltYW5kIGluIGFueSBv
ZiBteSBtZXNzYWdlcyxccGFyDQphbmQgSSBhbSBpbiBubyBwb3NpdGlvbiB0byBtYWtlIG9uZTsg
SSdtIGp1c3QgbG9va2luZyBhdCBpdCBhbGwgXHBhcg0KY2xpbmljYWxseS4gVGhlcmUgaXMgbm90
aGluZyBpbiB0aGUgc2l0dWF0aW9uIHRoYXQgd291bGQgZ28gYWdhaW5zdFxwYXINCnRoZSBsYXdz
IG9mIG5hdHVyZS5ccGFyDQpccGFyDQo+IFRoZXJlIG11c3QgYmUgc29tZSB3YXkgdGhhdCB0aGUg
QmxhY2tib3ggdXNlciBjb21tdW5pdHkgY2FuIGhlbHAgT21pbmMgXHBhcg0KPiBpbXByb3ZlIGl0
cyBkb2N1bWVudGF0aW9uLlxwYXINClxwYXINClRoYXQncyBleGFjdGx5IHRoZSBwb2ludC4gTGV0
J3Mgc2hpZnQgdGhlIGVtcGhhc2lzIHRvIHdoYXQgd2UgY2FuIGRvXHBhcg0KYXMgYSBjb21tdW5p
dHkuXHBhcg0KXHBhcg0KQ2hlZXJzXHBhcg0KRnlvZG9yXHBhcg0KLS0tLS0tLS0tLS0tLS0tLS0t
LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS1ccGFyDQpccGFyDQpUbyB1bnN1YnNjcmliZSBmcm9t
IHRoaXMgbWFpbGluZyBsaXN0LCBzZW5kIGEgbWVzc2FnZSBjb250YWluaW5nIHRoZSB3b3JkICJ1
bnN1YnNjcmliZSIgdG86XHBhcg0KICAgYmxhY2tib3gtcmVxdWVzdEBvYmVyb24uY2hccGFyDQpc
cGFyDQpUbyBnZXQgYSBsaXN0IG9mIHZhbGlkIGUtbWFpbCBjb21tYW5kcyBhbmQgaW5zdHJ1Y3Rp
b25zIG9uIHRoZWlyIHVzYWdlLCBzZW5kIGEgbWVzc2FnZSBjb250YWluaW5nIHRoZSB3b3JkICJo
ZWxwIiB0byB0aGUgYWJvdmUgYWRkcmVzcy5ccGFyDQpccGFyDQpTZW5kIGFueSBwcm9ibGVtIHJl
cG9ydHMgb3IgcXVlc3Rpb25zIHJlbGF0ZWQgdG8gdGhpcyBlbWFpbCBsaXN0IHRvIHRoZSBsaXN0
IG93bmVyIGF0XHBhcg0KICAgb3duZXItYmxhY2tib3hAb2Jlcm9uLmNoXHBhcg0KXHBhcg0KQ3Vy
cmVudCBwb3N0aW5nIHBvbGljeTpccGFyDQpccGFyDQphKSBUbyBwb3N0IHlvdSBzaG91bGQgdXNl
IHRoZSBzYW1lIGFkZHJlc3MgYnkgd2hpY2ggeW91IGFyZSBzdWJzY3JpYmVkIHRvIHRoZSBtYWls
aW5nIGxpc3QuIFRoYXQgd2F5LCB0aGUgbGlzdCBzZXJ2ZXIgd2lsbCByZWNvZ25pemUgeW91IGFz
IHN1YnNjcmliZXIgYW5kIGZvcndhcmQgeW91ciBwb3N0aW5nIGltbWVkaWF0ZWx5LCB3aXRob3V0
IGNyZWF0aW5nIGFueSBvdmVyaGVhZC5ccGFyDQpccGFyDQpiKSBJZiwgZm9yIHNvbWUgcmVhc29u
LCB5b3UgY2Fubm90IHBvc3QgZnJvbSB0aGUgYWRkcmVzcywgYnkgd2hpY2ggeW91IGFyZSBzdWJz
Y3JpYmVkLCB5b3VyIG1lc3NhZ2Ugd2lsbCBiZSBtb2RlcmF0ZWQgdG8gYXZvaWQgc3BhbS4gUGxl
YXNlIHVuZGVyc3RhbmQgdGhhdCBtb2RlcmF0aW9uIHdpbGwgb2Z0ZW4gY2F1c2Ugc29tZSBkZWxh
eSwgaW4gcGFydGljdWxhciBvdmVyIHdlZWtlbmRzIG9yIGhvbHlkYXlzLlxwYXINClxwYXINCn0=


----boundary-LibPST-iamunique-170398181_-_---
Received on Sun Aug 03 2003 - 01:28:34 UTC

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