[Plastic-devs] wiki organisation
Brought to you by:
johndavidtaylor,
thomasboch
|
From: Mark T. <m.b...@br...> - 2006-09-13 11:35:13
|
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/ |