:: Re: [DNG] Fwd: Re: What should an …
Top Pagina
Delete this message
Reply to this message
Auteur: Hendrik Boom
Datum:  
Aan: dng
Onderwerp: Re: [DNG] Fwd: Re: What should an Install Guide accomplish?
On Sat, Jan 05, 2019 at 10:34:21AM +0100, KatolaZ wrote:
>
> On the other hand, I personally think that an installation guide
> should be a "layered" document: the main thread being the "usual"
> install path with only the necessary details, and links to further
> information about specific points or possible bifucations. The main
> reason is that installation docs serve two (almost antithetic)
> purposes: the first one is to allow any newcomer to get a working
> system easily. The second one is to provide extensive information to
> those who like to understand what is going on under the hood. People
> in the first class need just a simple document with figures, people in
> the second lot would enjoy extensive explanations and detailed
> descriptions.


Straightforward main document with links to specific points,
bifurcations, and extensive explanations sounds about right.

-- hendrik