- Tutorial or Documentation?

From: Campbell, Robert D (UK Edinburgh) <"Campbell,>
Date: Mon, 21 Mar 2005 09:38:09 +0000

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



Various contributers wrote ...

>> > Where is ESPE21? Well I happen to know about CPC
>> > (
http://www.zinnamturm.de/#Epse21) but that is buried and

>> not easily
>> > accessible for new people.

>>

>>

>> That's it.
>>

>> Also a pre Lib-9 version is available from

>> http://cern.ch/oberon.day/ -- unzip and run.
>> I plan to update it in a foreseeable future.
>>

>> > Where to start? .. But why the name Map?

>>

>> I must assume the responsibility for any unfortunate naming

>> etc., since I was a kind of editor,
>> but the draft document itself must have been proposed by Robert.
>>

>> > So lets start with your documentation in ESPE21 but not


>> use that name.
>>

>> That's fine with me.

Yes, I used the name 'Map'. Generally I try to model my
Docu's on the Oms precedents. They use 'Map', or rather
'Sys-Map', as a top-level introduction / contents list.

The 'essbase' example posted is called 'infomap'.

At a rather more general level I find that many small
byperlinked Docu's work better for me than 1 large
monolithic document as has been proposed. For an example
see the 'Docupack' I put together for the half dozen subsystems
that make up Chill_09.

I do like the Oms style of Docu's as 'Reference Manual' material
(although some Modules are undocumented!). But that is only half
the story. I imagine/remember that getting started on your own
is difficult and daunting - but is that not true for every non-trivial
development environment? And we also need a 'knowledge base' of
special topic essays. For example a clear explanation of how to use
Properties or Domains.

Robert

********************************************************************
This email and any attachments are confidential to the intended
recipient and may also be privileged. If you are not the intended
recipient please delete it from your system and notify the sender.
You should not copy it or use it for any purpose nor disclose or
distribute its contents to any other person.
********************************************************************

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



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

e1xydGYxXGFuc2lcYW5zaWNwZzEyNTJcZnJvbXRleHQgXGRlZmYwe1xmb250dGJsDQp7XGYwXGZz
d2lzcyBBcmlhbDt9DQp7XGYxXGZtb2Rlcm4gQ291cmllciBOZXc7fQ0Ke1xmMlxmbmlsXGZjaGFy
c2V0MiBTeW1ib2w7fQ0Ke1xmM1xmbW9kZXJuXGZjaGFyc2V0MCBDb3VyaWVyIE5ldzt9fQ0Ke1xj
b2xvcnRibFxyZWQwXGdyZWVuMFxibHVlMDtccmVkMFxncmVlbjBcYmx1ZTI1NTt9DQpcdWMxXHBh
cmRccGxhaW5cZGVmdGFiMzYwIFxmMFxmczIwIFxwYXINClxwYXINClZhcmlvdXMgY29udHJpYnV0
ZXJzIHdyb3RlIC4uLlxwYXINClxwYXINCj4+ICA+IFdoZXJlIGlzIEVTUEUyMT8gIFdlbGwgSSBo
YXBwZW4gdG8ga25vdyBhYm91dCBDUENccGFyDQo+PiAgPiAoaHR0cDovL3d3dy56aW5uYW10dXJt
LmRlLyNFcHNlMjEpIGJ1dCB0aGF0IGlzIGJ1cmllZCBhbmRccGFyDQpccGFyDQo+PiAgbm90IGVh
c2lseVxwYXINCj4+ICA+IGFjY2Vzc2libGUgZm9yIG5ldyBwZW9wbGUuXHBhcg0KXHBhcg0KPj4g
XHBhcg0KXHBhcg0KPj4gXHBhcg0KXHBhcg0KPj4gIFRoYXQncyBpdC5ccGFyDQo+PiBccGFyDQpc
cGFyDQo+PiAgQWxzbyBhIHByZSBMaWItOSB2ZXJzaW9uIGlzIGF2YWlsYWJsZSBmcm9tXHBhcg0K
XHBhcg0KPj4gIGh0dHA6Ly9jZXJuLmNoL29iZXJvbi5kYXkvIC0tIHVuemlwIGFuZCBydW4uXHBh
cg0KPj4gIEkgcGxhbiB0byB1cGRhdGUgaXQgaW4gYSBmb3Jlc2VlYWJsZSBmdXR1cmUuXHBhcg0K
Pj4gXHBhcg0KXHBhcg0KPj4gID4gV2hlcmUgdG8gc3RhcnQ/IC4uIEJ1dCB3aHkgdGhlIG5hbWUg
TWFwP1xwYXINCj4+IFxwYXINClxwYXINCj4+ICBJIG11c3QgYXNzdW1lIHRoZSByZXNwb25zaWJp
bGl0eSBmb3IgYW55IHVuZm9ydHVuYXRlIG5hbWluZ1xwYXINClxwYXINCj4+ICBldGMuLCBzaW5j
ZSBJIHdhcyBhIGtpbmQgb2YgZWRpdG9yLFxwYXINCj4+ICBidXQgdGhlIGRyYWZ0IGRvY3VtZW50
IGl0c2VsZiBtdXN0IGhhdmUgYmVlbiBwcm9wb3NlZCBieSBSb2JlcnQuXHBhcg0KPj4gXHBhcg0K
XHBhcg0KPj4gID4gU28gbGV0cyBzdGFydCB3aXRoIHlvdXIgZG9jdW1lbnRhdGlvbiBpbiBFU1BF
MjEgYnV0IG5vdFxwYXINClxwYXINCj4+ICB1c2UgdGhhdCBuYW1lLlxwYXINCj4+IFxwYXINClxw
YXINCj4+ICBUaGF0J3MgZmluZSB3aXRoIG1lLlxwYXINClxwYXINClllcywgSSB1c2VkIHRoZSBu
YW1lICdNYXAnLiBHZW5lcmFsbHkgSSB0cnkgdG8gbW9kZWwgbXlccGFyDQpEb2N1J3Mgb24gdGhl
IE9tcyBwcmVjZWRlbnRzLiBUaGV5IHVzZSAnTWFwJywgb3IgcmF0aGVyXHBhcg0KJ1N5cy1NYXAn
LCBhcyBhIHRvcC1sZXZlbCBpbnRyb2R1Y3Rpb24gLyBjb250ZW50cyBsaXN0LlxwYXINClxwYXIN
ClRoZSAnZXNzYmFzZScgZXhhbXBsZSBwb3N0ZWQgaXMgY2FsbGVkICdpbmZvbWFwJy5ccGFyDQpc
cGFyDQpBdCBhIHJhdGhlciBtb3JlIGdlbmVyYWwgbGV2ZWwgSSBmaW5kIHRoYXQgbWFueSBzbWFs
bFxwYXINCmJ5cGVybGlua2VkIERvY3UncyB3b3JrIGJldHRlciBmb3IgbWUgdGhhbiAxIGxhcmdl
XHBhcg0KbW9ub2xpdGhpYyBkb2N1bWVudCBhcyBoYXMgYmVlbiBwcm9wb3NlZC4gRm9yIGFuIGV4
YW1wbGVccGFyDQpzZWUgdGhlICdEb2N1cGFjaycgSSBwdXQgdG9nZXRoZXIgZm9yIHRoZSBoYWxm
IGRvemVuIHN1YnN5c3RlbXNccGFyDQp0aGF0IG1ha2UgdXAgQ2hpbGxfMDkuXHBhcg0KXHBhcg0K
SSBkbyBsaWtlIHRoZSBPbXMgc3R5bGUgb2YgRG9jdSdzIGFzICdSZWZlcmVuY2UgTWFudWFsJyBt
YXRlcmlhbFxwYXINCihhbHRob3VnaCBzb21lIE1vZHVsZXMgYXJlIHVuZG9jdW1lbnRlZCEpLiBC
dXQgdGhhdCBpcyBvbmx5IGhhbGZccGFyDQp0aGUgc3RvcnkuIEkgaW1hZ2luZS9yZW1lbWJlciB0
aGF0IGdldHRpbmcgc3RhcnRlZCBvbiB5b3VyIG93blxwYXINCmlzIGRpZmZpY3VsdCBhbmQgZGF1
bnRpbmcgLSBidXQgaXMgdGhhdCBub3QgdHJ1ZSBmb3IgZXZlcnkgbm9uLXRyaXZpYWxccGFyDQpk
ZXZlbG9wbWVudCBlbnZpcm9ubWVudD8gQW5kIHdlIGFsc28gbmVlZCBhICdrbm93bGVkZ2UgYmFz
ZScgb2ZccGFyDQpzcGVjaWFsIHRvcGljIGVzc2F5cy4gRm9yIGV4YW1wbGUgYSBjbGVhciBleHBs
YW5hdGlvbiBvZiBob3cgdG8gdXNlXHBhcg0KUHJvcGVydGllcyBvciBEb21haW5zLlxwYXINClxw
YXINClJvYmVydFxwYXINClxwYXINCioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioq
KioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqXHBhcg0KVGhpcyBlbWFpbCBhbmQgYW55
IGF0dGFjaG1lbnRzIGFyZSBjb25maWRlbnRpYWwgdG8gdGhlIGludGVuZGVkXHBhcg0KcmVjaXBp
ZW50IGFuZCBtYXkgYWxzbyBiZSBwcml2aWxlZ2VkLiBJZiB5b3UgYXJlIG5vdCB0aGUgaW50ZW5k
ZWRccGFyDQpyZWNpcGllbnQgcGxlYXNlIGRlbGV0ZSBpdCBmcm9tIHlvdXIgc3lzdGVtIGFuZCBu
b3RpZnkgdGhlIHNlbmRlci5ccGFyDQpZb3Ugc2hvdWxkIG5vdCBjb3B5IGl0IG9yIHVzZSBpdCBm
b3IgYW55IHB1cnBvc2Ugbm9yIGRpc2Nsb3NlIG9yXHBhcg0KZGlzdHJpYnV0ZSBpdHMgY29udGVu
dHMgdG8gYW55IG90aGVyIHBlcnNvbi5ccGFyDQoqKioqKioqKioqKioqKioqKioqKioqKioqKioq
KioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKioqKlxwYXINClxwYXINCi0tLSBC
bGFja0JveFxwYXINCi0tLSBzZW5kIHN1YmplY3QgSEVMUCBvciBVTlNVQlNDUklCRSB0byBibGFj
a2JveEBvYmVyb24uY2h9fQAOAAAAAAAAAwAA


----boundary-LibPST-iamunique-763144839_-_---
Received on Mon Mar 21 2005 - 10:38:09 UTC

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