Use Tocbot for dynamic table of contents in User Guide

[sbrannen]

Overview

Over time the amount of content in the User Guide grows and grows. Consequently, it becomes harder to actually navigate the User Guide.

In order not to overwhelm the reader but simultaneously provide enough contextual information for "where you currently are" within the User Guide, it would be beneficial to integrate Tocbot in the JUnit 5 User Guide.

Tocbot can be integrated into Asciidoctor analogous to how the Spring Framework did in spring-projects/spring-framework@ee3913c. Note, however, that some of the files in that initial commit have been modified over time.

To see the result of the Tocbot integration into Spring's Reference Manual, take a look at the Testing chapter.

Related Issues

• Add expandable/collapsable TOC asciidoctor/asciidoctor#699

Deliverables

• Integrate Tocbot in the User Guide.