[Plastic-devs] wiki organisation

[Mark T. <m.b...@br...>]

All,

the current organisation of descriptions for the standard and 
proposed messages on the wiki (one table row per message) does not 
encourage detailed descriptions.  We have had many long discussions 
on some of these messages which are now buried in the list archives 
somewhere and hard to locate.

I suggest it would be a good idea to have a wiki page for each message
(e.g. SpectrumLoadFromURL), which would make it easier to record
properly detailed definitions of what each message, along with each
of its arguments, is supposed to mean.  These pages could also host 
the the various debates, clarifications, compromises etc which are
associated with the message, for historical interest and to inform
future debates about new messages or changes to existing ones.  
There would still a central page listing the messages and linking
to these per-message pages of course.

The question of who has the time or enthusiasm to re-organise the
existing documentation in this way is another matter however...

Mark

-- 
Mark Taylor   Astronomical Programmer   Physics, Bristol University, UK
m.b...@br... +44-117-928-8776 http://www.star.bris.ac.uk/~mbt/