While on the subject of nits, here's one from the background section:

"However, no updates have been made since version 1.3.8, released in 1998."

Probably true when it was written but no longer.


On Monday 29 March 2004 10:45 pm, Gary Gregory wrote:
> Looks much better! Now I might be nit picking here but here it goes
> anyway.
>
> (1) IMHO, the 1st sentence ("This is an Internet protocol suite Java
> library originally developed by ORO, Inc.") should be moved to the
> Background section. The first sentence should tell you something very
> important, this isn't it. To me, this is like with a Javadoc comment,
> the 1st sentence is extracted as a summary, so the 1st sentence should
> tell you in a nutshell what commons-net is all about.
>
> (2) In the Features, section, I would replace "Supported protocols
> include:" with "The supported protocols are:" and list them all.
>
> (3) Spelling errors/typos:
>
> protocal -> protocol
> accesible -> accessible
> e.g -> e.g.
> NetComponents -> Jakarta commons-net
> the The Apache Software License - the Apache Software License
>
> Nitpickin',
> Gary
>
> > -----Original Message-----
> > From: Jeffrey D. Brekke [mailto:[EMAIL PROTECTED]
> > Sent: Monday, March 29, 2004 20:31
> > To: Jakarta Commons Developers List
> > Subject: Re: [net] [vote] Release Commons-Net 1.2
> >
> > >>>>> On Mon, 29 Mar 2004 00:25:59 -0500, Gary Gregory
> >
> > <[EMAIL PROTECTED]> said:
> > > WRT http://jakarta.apache.org/commons/net/ Shouldn't the heading
> > > "Jakarta Commons/Net" probably just be "Jakarta Commons Net"?
> > >
> > > Also that whole paragraph could use some formatting, for example a
> > > bullet list of features.
> >
> > Agreed.  I took a stab at reformatting the index.  No new information,
> > just broke up a little more.
> >
> > http://jakarta.apache.org/commons/net/
> >
> > --
> > =====================================================================
> > Jeffrey D. Brekke                                   [EMAIL PROTECTED]
> > Wisconsin,  USA                                     [EMAIL PROTECTED]
> >                                                     [EMAIL PROTECTED]
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: [EMAIL PROTECTED]
> > For additional commands, e-mail: [EMAIL PROTECTED]
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to