Bug 56883

Summary: Inadequately-documented charter for freebsd-jobs@
Product: Documentation Reporter: david
Component: Books & ArticlesAssignee: freebsd-doc (Nobody) <doc>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
file.diff none

Description david 2003-09-15 05:10:21 UTC 
	Direct the Web browser of your choice to
http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/eresources.html#ERESOURCES-MAIL;
note that although there is a one-line summary for freebsd-jobs, there
is not "charter" listed.

This PR was catalyzed by receipt of a message, of which the following is
a relevant excerpt:

How-To-Repeat: 	Keep looking at the page cited above.  :-)
Comment 1 Warren Block 2003-09-15 12:23:28 UTC 
On Sun, 14 Sep 2003, David Wolfskill wrote:

>  >We need to add some text to the charter for the jobs@ list.  Please add
>  >some text encouraging people posting job availability to clearly state
>  >WHERE the job is available and if relocation will be reimbursed.

>  +	    <para>Note that this list, like other mailing lists
>  +	      @FreeBSD.ORG, is distributed worldwide.  Thus, you

              ^ I think the "@" symbol there should be spelled out
(you're talking about mailing lists, not specific email addresses, so
the @ is inappropriate).  The .ORG should probably not be capitalized,
either:

   +	      at FreeBSD.org, is distributed worldwide.  Thus, you

>  +	    <para>All email should be open source formats only.
>  +	      Examples of open source formats include PostScript
>  +	      (.ps), Portable Document Format (.pdf) and ASCII text.

A slight rewrite and reorganization from most common to less common:

   +        <para>Email must be in open source formats only.  Plain
   +          ASCII text, Portable Document Format (PDF), or PostScript
   +          are appropriate.

(Is PostScript really something that should be mentioned here?  It has
more interchange issues than either of the others.  I'm also unsure
whether "open source" is a good description of these formats, but can't
think of anything better at the moment.)

>  +	      Proprietary formats such as MicroSoft Word (.doc) are
>  +	      not accepted.</para>

And maybe a change of tense?

>  +          Proprietary formats such as MicroSoft Word (.doc) will
>  +          not accepted.</para>

-Warren Block * Rapid City, South Dakota USA
Comment 2 Simon L. B. Nielsen freebsd_committer freebsd_triage 2004-01-17 23:48:14 UTC 
State Changed
From-To: open->closed

Committed with modifications based on review on -doc, and some minor 
stuff by me.  Thanks for the submission!