Re: Additional Chapter for Tutorial

Removing -docs as moderation won’t let me cross-post.

On Monday, October 26, 2020, David G. Johnston <david.g.johnston@gmail.com>
wrote:

> On Monday, October 26, 2020, Jürgen Purtz <juergen@purtz.de> wrote:
>
>> On 21.10.20 22:33, David G. Johnston wrote:
>>
>>
>> Two, I find the amount of detail being provided here to be on the
>> too-much side.  A bit more judicious use of links into the appropriate
>> detail chapters seems warranted.
>>
>> The patch is intended to give every interested person an overall
>> impression of the chapter within its new position. Because it has moved
>> from part 'Tutorial' to 'Internals' the text should be very accurate
>> concerning technical issues - like all the other chapters in this part. A
>> tutorial chapter has a more superficial nature.
>>
> Haven’t reviewed the patches yet but...
>
> I still think that my comment applies even with the move to internals.
> The value here is putting together a coherent narrative and making deeper
> implementation details accessible.  If those details are already covered
> elsewhere in the documentation (not source code) links should be given
> serious consideration.
>
> David J.
>
>