- Agreement: Where should documentation reside?

From: Douglas G. Danforth <"Douglas>
Date: Fri, 25 Mar 2005 12:45:10 -0500

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

Campbell, Robert D (UK Edinburgh) wrote:
>
>>> Issue: Blackbox documentation
[snip]

> My vote:
>
> Master copy: - The CPC page.
I also vote for this. In addition a hyper link to CPC (more clearly
stated) on the Oberon Microsystems BlackBox page is needed that mentions
documentation.

> Working copies: - Each users PC (or unix box?).
Yes

> Format: - Hyperlinked .odc files.
Now this is questionable. Why? It forces new comers to install BlackBox
on their machine *before* they can read the documentation. I think that
is a potential problem. For those who have the system, yes this is very
good and allows for the full use of document centered computing, as
Fyodor has so nicely shown with his EPSE-21 work.

I am interested in increasing the number of users of BlackBox and so
would hope to have the documentation lie outside of the BlackBox
environment. That is why Wiki is attractive, and why HTML text is also
attractive. They, however, restrict the full presentation of BlackBox.
  So we have a conundrum (or at least I do).

-Doug

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



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

e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcZnJvbXRleHQgXGRlZmYwe1xmb250dGJsDQp7XGYwXGZz
d2lzcyBBcmlhbDt9DQp7XGYxXGZtb2Rlcm4gQ291cmllciBOZXc7fQ0Ke1xmMlxmbmlsXGZjaGFy
c2V0MiBTeW1ib2w7fQ0Ke1xmM1xmbW9kZXJuXGZjaGFyc2V0MCBDb3VyaWVyIE5ldzt9fQ0Ke1xj
b2xvcnRibFxyZWQwXGdyZWVuMFxibHVlMDtccmVkMFxncmVlbjBcYmx1ZTI1NTt9DQpcdWMxXHBh
cmRccGxhaW5cZGVmdGFiMzYwIFxmMFxmczIwIENhbXBiZWxsLCBSb2JlcnQgRCAoVUsgRWRpbmJ1
cmdoKSB3cm90ZTpccGFyDQo+IFxwYXINCj4+PiBJc3N1ZTogQmxhY2tib3ggZG9jdW1lbnRhdGlv
blxwYXINCltzbmlwXVxwYXINCj4gTXkgdm90ZTpccGFyDQo+IFxwYXINCj4gTWFzdGVyIGNvcHk6
ICAgIC0gVGhlIENQQyBwYWdlLlxwYXINCkkgYWxzbyB2b3RlIGZvciB0aGlzLiAgSW4gYWRkaXRp
b24gYSBoeXBlciBsaW5rIHRvIENQQyAobW9yZSBjbGVhcmx5IFxwYXINCnN0YXRlZCkgb24gdGhl
IE9iZXJvbiBNaWNyb3N5c3RlbXMgQmxhY2tCb3ggcGFnZSBpcyBuZWVkZWQgdGhhdCBtZW50aW9u
cyBccGFyDQpkb2N1bWVudGF0aW9uLlxwYXINClxwYXINCj4gV29ya2luZyBjb3BpZXM6IC0gRWFj
aCB1c2VycyBQQyAob3IgdW5peCBib3g/KS5ccGFyDQpZZXNccGFyDQpccGFyDQo+IEZvcm1hdDog
ICAgICAgICAtIEh5cGVybGlua2VkIC5vZGMgZmlsZXMuXHBhcg0KTm93IHRoaXMgaXMgcXVlc3Rp
b25hYmxlLiAgV2h5PyBJdCBmb3JjZXMgbmV3IGNvbWVycyB0byBpbnN0YWxsIEJsYWNrQm94IFxw
YXINCm9uIHRoZWlyIG1hY2hpbmUgKmJlZm9yZSogdGhleSBjYW4gcmVhZCB0aGUgZG9jdW1lbnRh
dGlvbi4gIEkgdGhpbmsgdGhhdCBccGFyDQppcyBhIHBvdGVudGlhbCBwcm9ibGVtLiAgRm9yIHRo
b3NlIHdobyBoYXZlIHRoZSBzeXN0ZW0sIHllcyB0aGlzIGlzIHZlcnkgXHBhcg0KZ29vZCBhbmQg
YWxsb3dzIGZvciB0aGUgZnVsbCB1c2Ugb2YgZG9jdW1lbnQgY2VudGVyZWQgY29tcHV0aW5nLCBh
cyBccGFyDQpGeW9kb3IgaGFzIHNvIG5pY2VseSBzaG93biB3aXRoIGhpcyBFUFNFLTIxIHdvcmsu
XHBhcg0KXHBhcg0KSSBhbSBpbnRlcmVzdGVkIGluIGluY3JlYXNpbmcgdGhlIG51bWJlciBvZiB1
c2VycyBvZiBCbGFja0JveCBhbmQgc28gXHBhcg0Kd291bGQgaG9wZSB0byBoYXZlIHRoZSBkb2N1
bWVudGF0aW9uIGxpZSBvdXRzaWRlIG9mIHRoZSBCbGFja0JveCBccGFyDQplbnZpcm9ubWVudC4g
IFRoYXQgaXMgd2h5IFdpa2kgaXMgYXR0cmFjdGl2ZSwgYW5kIHdoeSBIVE1MIHRleHQgaXMgYWxz
byBccGFyDQphdHRyYWN0aXZlLiAgVGhleSwgaG93ZXZlciwgcmVzdHJpY3QgdGhlIGZ1bGwgcHJl
c2VudGF0aW9uIG9mIEJsYWNrQm94LiBccGFyDQogIFNvIHdlIGhhdmUgYSBjb251bmRydW0gKG9y
IGF0IGxlYXN0IEkgZG8pLlxwYXINClxwYXINCi1Eb3VnXHBhcg0KXHBhcg0KLS0tIEJsYWNrQm94
XHBhcg0KLS0tIHNlbmQgc3ViamVjdCBIRUxQIG9yIFVOU1VCU0NSSUJFIHRvIGJsYWNrYm94QG9i
ZXJvbi5jaH19AOMTYXgAAAAaAAA=


----boundary-LibPST-iamunique-1080478063_-_---
Received on Fri Mar 25 2005 - 18:45:10 UTC

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