T. J. Frazier wrote:
Hi, Michele,
Do you think some of the following (your) explanations belong in the
*File > Properties > Description > Comments* part of the template? I
suggest that the design considerations should be recorded. /tj/
I agree. We always had/have some esoteric bug workarounds and
nonstandard ways of doing some things that would require a Rosetta Stone
for the uninitiated to have in their possession in order to decipher
some of those workarounds.
There should be documentation to the how and why we do them, especially
for any novices to OOo or for newcomers in general.
At least, we are now eating more of our own home cooking and not using
all the manual overrides as in the past that our user guides preach to
users not to use themselves. But again, we introduce other obscurities
without giving adequate disclosure of how or why. That would make it
extremely difficult for future editors and authors to deal with if those
who implemented them in the first place were no longer around.
That custom involving the lack of commenting and documentation was done
by computer programmers thirty years ago for (their own) job-security
purposes...
Gary
--
Gary Schnabl
2775 Honorah
Detroit MI 48209