Removing -docs as moderation won’t let me cross-post. On Monday, October 26, 2020, David G. Johnston <david.g.johns...@gmail.com> wrote:
> On Monday, October 26, 2020, Jürgen Purtz <juer...@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. > >
