coding + doc standards

cwg@DeepEddy.Com cwg@DeepEddy.Com
Wed, 14 May 1997 15:32:28 -0500

Content-Type: text/plain; charset=us-ascii

> I believe somebody mentioned a while ago something about naming conventions
> and such. Shouldn't the project adopt some sort of coding, naming and
> documentation standard so if anybody wants to go about already writing
> higher level applications they can do so. It would also be necessary in
> order for the lispOS to be a sustainable effort instead of a collection of
> modules written in wildly different styles difficult to make sense of.

The answer is, of course, "absolutely".

On the documentation side of things, it would be nice if someone were to 
dedicate themselves to writing an on-line documentation system using CLIM.  
Such a system would probably have much of it's data defined in source code so
that the on-line documentation would be located *with* the code that it
documents in order to increase the likelyhood that the documentation gets
updated when the code gets updated.


Chris Garrigues                    O-              cwg@DeepEddy.Com
  Deep Eddy Internet Consulting                     +1 512 432 4046
  609 Deep Eddy Avenue
  Austin, TX  78703-4513              http://www.DeepEddy.Com/~cwg/

Content-Type: application/pgp-signature

Version: 2.6.2