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.
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.