[LON-CAPA-dev] Re: solution found
Thu, 07 Feb 2002 11:19:20 -0500
Scott Harrison wrote:
> The real solution is to have
> A) either an entry interface to troubleshoot input
> (dashes in names, crappy hosts.tab entries, horrible
> B) and/or a script that checks to see "if things look good"
> C) and/or really thorough installation/configuration/upgrading
> documentation that nobody reads
> I agree.. at some point we have to
> hold the line against the GIGO (garbage in
> garbage out) principle.
YEP on A) and B). The solution for C) is a staggered documentation approach -
"Installation for Dummies" (meaning, in reality, people who just want a box up and
running and not deal with details - vanilla install) with very few steps using A)
including B) . Then hyperlinks from within documentation to increasingly more
detailed information of how to tweak stuff if you want and dare to.