making review/bug filing optional for some docs changes

Jason Pyeron jpyeron at pdinc.us
Fri Mar 18 17:52:37 UTC 2005


On Fri, 18 Mar 2005, Benton, Kevin wrote:

>
> Because we're maintaining enterprise-level software (and we advertise it
> that way), we need to handle it as an enterprise-level entity would.  In
> my experience at that level, to ensure high quality, any time a change
> is put in place that could impact a customer, a release process needs to
> be followed.  Because documentation is viewed by our "customers," I feel
> it should be kept inside the release process.  This prevents human error
> from leaking out.  Note I didn't say eliminate human error.  It's

Our customers could not tolerate anything less.

> possible that a reviewer could miss something.  On the other hand, if we
> don't follow the release process, we can not benefit from catching
> problems before they're released.  Therefore, with documentation being
> such a high-visibility part of our product, I would suggest that no
> matter who is making the documentation update, that it follow a release
> process.  Whether that involves just one or two reviewers is not the
> issue with me.  I think one reviewer on documentation is a fair balance
> giving us the greatest flexibility to move quickly but still have a
> check/balance for doc updates.
>

How about a new enter bug template just for doc updates?

Version, patch, summary, and an optional explanation.

This will allow them to drop and go.



-- 
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
-                                                               -
- Jason Pyeron                      PD Inc. http://www.pdinc.us -
- Partner & Sr. Manager              #1 2739 Saint Paul Street  -
- +1 (410) 808-6646 (c)              Baltimore, Maryland 21218  -
-                                                               -
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

This message is for the designated recipient only and may contain 
privileged, proprietary, or otherwise private information. If you 
have received it in error, purge the message from your system and 
notify the sender immediately.  Any other use of the email by you 
is prohibited.




-- 
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
-                                                               -
- Jason Pyeron                      PD Inc. http://www.pdinc.us -
- Partner & Sr. Manager              #1 2739 Saint Paul Street  -
- +1 (410) 808-6646 (c)              Baltimore, Maryland 21218  -
-                                                               -
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-

This message is for the designated recipient only and may contain 
privileged, proprietary, or otherwise private information. If you 
have received it in error, purge the message from your system and 
notify the sender immediately.  Any other use of the email by you 
is prohibited.





More information about the developers mailing list