Great Circle Associates Majordomo-Docs
(September 1993)
 

Indexed By Date: [Previous] [Next] Indexed By Thread: [Previous] [Next]

Subject: Re: New mailing list for Majordomo documentation helpers
From: "Beth E. Binde" <binde @ plinius . rutgers . edu>
Date: Wed, 15 Sep 93 18:33:29 EDT
To: Brent Chapman <brent @ GreatCircle . COM>
Cc: majordomo-docs @ GreatCircle . COM
In-reply-to: Your message of Wed, 15 Sep 93 15:14:38 -0700

> I think the first thing we need to settle is procedural: how are we going
> to go about editing these documents?  I don't think the traditional method
> of dealing with source code (i.e., mailing "diff" output around) will work
> well for text.  Anybody got any suggestions?

Since you've already provided a draft for us to work on, I would suggest 
that any editing suggestions we make be marked down the left side with 
the vertical bar.   Like this: 

| This is an example.  Here is another one.  
  This isn't one.  
  And neither is this.  

This draws attention to what the changes are, while still preserving
the flow of the prose.  The issue of what to do if we disagree on
wording is a bit stickier, but I suspect that lots of "procedures"
won't help terribly with that. :-)



Beth E. Binde, Systems Programmer 
Rutgers University Computing Services, Piscataway, NJ 08855-0879 USA  
EMAIL: binde@noc.rutgers.edu   VOICE:  908-932-5019 



Indexed By Date Previous: Current draft of info for Majordomo list owners
From: brent@GreatCircle.COM (Brent Chapman)
Next: Re: Current draft of info for Majordomo list owners
From: "Beth E. Binde" <binde@plinius.rutgers.edu>
Indexed By Thread Previous: New mailing list for Majordomo documentation helpers
From: Brent Chapman <brent@GreatCircle.COM>
Next: Current draft of info for Majordomo list owners
From: brent@GreatCircle.COM (Brent Chapman)

Google
 
Search Internet Search www.greatcircle.com