Path: csiph.com!x330-a1.tempe.blueboxinc.net!newsfeed.hal-mli.net!feeder3.hal-mli.net!newsfeed.hal-mli.net!feeder1.hal-mli.net!npeer02.iad.highwinds-media.com!news.highwinds-media.com!feed-me.highwinds-media.com!border3.nntp.dca.giganews.com!Xl.tags.giganews.com!border1.nntp.dca.giganews.com!nntp.giganews.com!local2.nntp.dca.giganews.com!nntp.earthlink.com!news.earthlink.com.POSTED!not-for-mail
NNTP-Posting-Date: Tue, 28 Feb 2012 03:39:04 -0600
Date: Tue, 28 Feb 2012 01:39:03 -0800
From: Patricia Shanahan <pats@acm.org>
User-Agent: Mozilla/5.0 (Windows NT 5.2; WOW64; rv:10.0.1) Gecko/20120208 Thunderbird/10.0.1
MIME-Version: 1.0
Newsgroups: comp.lang.java.programmer
Subject: Re: Aspect questions?
References: <XnsA0039B9FFFA32jpnasty@94.75.214.39> <ji8u23$f6m$1@news.albasani.net> <XnsA00493ECED98jpnasty@94.75.214.39> <jia398$bho$1@news.albasani.net> <XnsA0047B96E59BFjpnasty@94.75.214.39> <jibf3u$ee9$1@news.albasani.net> <XnsA004B034AE631jpnasty@94.75.214.39> <jibn8n$17s$1@news.albasani.net> <XnsA004BD220634Ejpnasty@94.75.214.39> <jibso4$bv2$1@news.albasani.net> <XnsA0057F0ABEC37jpnasty@94.75.214.39> <4f4a6b1d$0$290$14726298@news.sunsite.dk> <XnsA005A56D659E8jpnasty@94.75.214.39> <4f4ac151$0$291$14726298@news.sunsite.dk> <jiekrs$tk3$2@news.albasani.net> <4f4ad9ff$0$292$14726298@news.sunsite.dk> <jif4aq$tnp$1@news.albasani.net> <4f4c3df1$0$281$14726298@news.sunsite.dk> <jii1q4$f45$1@news.albasani.net>
In-Reply-To: <jii1q4$f45$1@news.albasani.net>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
Message-ID: <CaCdnXluDfclPdHSnZ2dnUVZ_gmdnZ2d@earthlink.com>
Lines: 21
X-Usenet-Provider: http://www.giganews.com
NNTP-Posting-Host: 70.230.206.198
X-Trace: sv3-GkQwfwHg57Pmj3571rpPYFl0wp04Iz5QrMTf/7qY2oVcg4mZdu5SmWf3XaLYXu1WZnSH1P2hrzxdbp7!y+RYpGJJSC0O/6VGN7KPcBXVLlLG1kJGaWfo/6t08X4cgUEajVL1pDcXxg66vS1XzYLa0vkPo0GR!2ni5PkJx31XNjrkajUAGTVJyfagBd1Puiu4ZcyX5VfK33ms=
X-Abuse-and-DMCA-Info: Please be sure to forward a copy of ALL headers
X-Abuse-and-DMCA-Info: Otherwise we will be unable to process your complaint properly
X-Postfilter: 1.3.40
X-Original-Bytes: 2660
X-Received-Bytes: 2801
Xref: x330-a1.tempe.blueboxinc.net comp.lang.java.programmer:12482

On 2/28/2012 12:04 AM, Lew wrote:
...
> You illustrate one way in which programming is a matter of art.
...

When it does come down to an art, after applying whatever science I have
available, I often resort to the "What is easiest to document?" test.
For example, I like a method for which it is really easy to write a
Javadoc comment, especially the first sentence.

To apply this to a packaging issue, try to write the Javadoc description(s).

If you find yourself, within one package, having to say a lot about some
particular subset of the classes, consider making that subset a separate
package. The subset has a lot of commonality or interaction.

If you find yourself doing a lot of cross-referencing between package
descriptions, or repeating a lot of material, you may have divided
things up too much.

Patricia