[ Walt Haas writes: ]
>
> Jason L Tibbitts III <tibbs@hpc.uh.edu> wrote:
>
> > >>>>> "DP" == David Potter <potter@csuite.chebucto.ns.ca> writes:
> >
> > DP> I recommend real examples...
> >
> > Of course, you then have to be sure that you don't use real
> > machines, list names or addresses, because then they'll neglect to
> > change them.
>
> There's another approach [...] That is to have the relevant hostnames
> and directories represented in the document as parameters, and have
> the installation procedure configure them to the real hostname and
> directories of the target machine.
And if the configuration is wrong, then the examples are wrong as well.
What about the configuration documentation, how does one do parameter
substitution before the configuration is even attempted? A good idea,
but it doesn't really cover all the bases.
--
Dave Wolfe
Follow-Ups:
References:
|
|
