Comment 2 for bug 1848524

Revision history for this message
Remington Steed (rjs7) wrote :

A few quick observations, which I haven't heard Blake mention yet:

Pros:
- Antora has a solution for our frequent broken page links (they call them "Page IDs").
- Antora requires a level of organization that I think would benefit us. Even if we don't choose to use Antora, we should consider adopting some of their practices.

Cons:
- Antora doesn't seem to have a way to add "Previous / Next" links, which we currently have on every docs page. They do have a persistent left navigation / table of contents, which serves a similar purpose, but not identical. We should decide if this difference is important for us.