> On Tue, 1 Jan 2019 19:04:32 -0800
> Rick Moen <rick@???> wrote:
>
> Yes, but in a "how to do it" document (like documentation on a distro's
> install procedure), once you've articulated the steps and substeps and
> what could go wrong and how to deal with it, you're done. Any requests
> for further info, such as theoretical underpinnings, can be done in a
> separate document.

I always want more information before I start a compilcated procedure,
especially if that complicated procedure is mostly automated so that I
don't have to attend the details.

I always want to understand the theoretical underpinnings.

That said, once I do understand, I want a compact exposition of the
steps and substeps I have to follow as I follow them.

The document I want is such a compact exposition, but with links to
the theoretical underpinnings. It drives me crazy not to know what's
really going on.

-- hendrik