[LON-CAPA-dev] Re: solution found

Gerd Kortemeyer lon-capa-dev@mail.lon-capa.org
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
>    access(loncapa).conf)
> 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.