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]