fantasai <[EMAIL PROTECTED]> wrote in message news:<[EMAIL PROTECTED]>... > Arron wrote: > > This is my persepective. Take out of it whatever you want.. I hope > > something in here is helpfull. > Thanks very much; your explanation helps a lot. It sounds like we need > a combination of direct editing, document commenting, and technotes. What comes to mind here for me is "Lower the bar!"
I can imagine someone *just hypothetically, of course* finding a gap, or error, or flaw and just shrugging because the reporting process is too time-consumming (read: frustrating, convoluted, unrewarding) or simply invisible. It _isn't_ unreasonable to expect a lot of people to, in effect, join the docs team by contributing ... but not with the current state of things. *And no, I don't find Moz unique in this ... maybe a tad peculiar, but not unique.* When I look at how document annotation and versionning has come along since I started dreaming in technicolor (circa '84) I'm really underwhelmed. This, for me, is a big lovely slab of grunge we can clear from our process. What I have in mind is this: even if contributions leave nothing more than a collection of "This sux!", What the F do you mean?", and "Where's the beef?!!" then at least we have a set of custom-placed alerts, alerts place by the sole authoritative body: those who experienced the pain. An example of this "better a whole pile of low-level comments than nothing" can be seen in the zope book, see http://www.zope.org/Documentation/ZopeBook/IntroducingZope.stx for example. A while back I used an interesting online annotation demo ... the URL for which was uhhh right there ummm a little while ago. *sigh* > ~fantasai hfx_ben
