Rework the information on section lengths.

Review Request #11691 — Created June 30, 2021 and submitted

Information

DiffX
master

Reviewers

This clarifies the length= option for sections. It explains when a
length is required and when it isn't, how a length is calculated, and
the rationale for the lengths.

Lengths are no longer optional. Content sections (preambles, metadata,
diffs) now require it.

Some lengths in examples have been fixed to be accurate for the
provided content.

Built the docs and read through the affected sections.

Tested all lengths in the examples to make sure they were now correct.

Summary ID
Rework the information on section lengths.
This clarifies the `length=` option for sections. It explains when a length is required and when it isn't, how a length is calculated, and the rationale for the lengths. Lengths are no longer optional. Content sections (preambles, metadata, diffs) now require it. Some lengths in examples have been fixed to be accurate for the provided content.
f34d344581e9f9a33de731f66bebd8357b6b4e8b
david
  1. Ship It!
  2. 
      
chipx86
Review request changed
Status:
Completed