[LON-CAPA-dev] Re: solution found

[Gerd Kortemeyer]

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.