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

Reply via email to