Once we have a multi-page docs, the URLs will look like as follows:

https://www.optaplanner.org/docs/latest/ConstraintStreams/ConstraintStreams-chapter.html

The URLs could be simplified:

• drop the "-chapter" suffix
• hyphenize the .adoc file names to have hyphenized URLs

• •  improves SEO as hyphens splits individual words
  • URL are more human-readable

Result:

https://www.optaplanner.org/docs/latest/constraint-streams/constraint-streams.html