ircII [LSARC/2008/373 FastTrack timeout 06/18/2008]

[James Carlson]

Dean Roehrich writes:
> On this page:
> http://sac.eng/BestPractices/interface_taxonomy.html
> 
> I saw the following under "Volatile" and felt that it applied:
> 
>   "This classification is typically used for free or open source software
>   (FOSS),..."

Yeah, advice like that always gets us into trouble.  ;-}

> When I read the description of "Project Private" I felt it didn't quite fit as
> well.
> 
> And, I'm still wrapping my brain around this stuff and I could just be
> misunderstanding things.
> 
> I guess it makes more sense for the script and help directories and contents
> to have the same classification...dunno why I did it that way.
> 
> So, maybe do them this way...?
> 
>     /usr/share/irc/script       Uncommitted         Scripts location
>     /usr/share/irc/script/*     Project Private     Individual script
>                                                       files (many).
>     /usr/share/irc/help         Uncommitted         Online Help files location
>     /usr/share/irc/help/*       Project Private     Individual help files,
>                                                       per irc sub-command

I'd make them all Project Private.

The key question you need to ask yourself is, "should any other
project be trying to add files to these directories, or reading the
files there, or depending on them in any way?"  If the answer is "no"
(and I think this is a good example of "no"), then they're Project
Private.

"Uncommitted" means that we're not committing to keeping the
directories themselves, but they should be documented in case users or
other applications want to futz with them.  That doesn't make sense in
this case.

-- 
James Carlson, Solaris Networking              <james.d.carlson at sun.com>
Sun Microsystems / 35 Network Drive        71.232W   Vox +1 781 442 2084
MS UBUR02-212 / Burlington MA 01803-2757   42.496N   Fax +1 781 442 1677