Section Length

What is it?

This metric aims at keeping the length of the sections small.

A section is defined as the content in between two headings.

A rule of thumb is to aim for 300-word long sections (usually 4 paragraphs or 20 sentences).

If any section has a number of words higher than 300 but lower than 600, the metric is flagged as Warning.

If any section has a number of words higher than 600, the metric is flagged as Problem.

Why does it matter?

Table of content

Meaningful headings enables the creation of a clear Table of Contents (built-in Confluence macro).

It gives an overview of what the reader can find in the page.

Structure the content

A section gathers the content around a common idea or concept.

Progression through the content

Readers can skim through your content to quickly find what they are looking for.

How to improve the Section Length?

Add headings

If several paragraphs tackle the same topic, group them into a section with a dedicated heading.


Leave a Reply 0

Your email address will not be published. Required fields are marked *