You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@artemis.apache.org by "ASF GitHub Bot (Jira)" <ji...@apache.org> on 2026/06/09 17:09:00 UTC
[jira] [Work logged] (ARTEMIS-6111) Migrate doc build to Antora
[ https://issues.apache.org/jira/browse/ARTEMIS-6111?focusedWorklogId=1024335&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-1024335 ]
ASF GitHub Bot logged work on ARTEMIS-6111:
-------------------------------------------
Author: ASF GitHub Bot
Created on: 09/Jun/26 17:08
Start Date: 09/Jun/26 17:08
Worklog Time Spent: 10m
Work Description: jbertram opened a new pull request, #6506:
URL: https://github.com/apache/artemis/pull/6506
(no comment)
Issue Time Tracking
-------------------
Worklog Id: (was: 1024335)
Remaining Estimate: 0h
Time Spent: 10m
> Migrate doc build to Antora
> ---------------------------
>
> Key: ARTEMIS-6111
> URL: https://issues.apache.org/jira/browse/ARTEMIS-6111
> Project: Artemis
> Issue Type: Task
> Reporter: Justin Bertram
> Assignee: Justin Bertram
> Priority: Major
> Labels: pull-request-available
> Time Spent: 10m
> Remaining Estimate: 0h
>
> The current AsciiDoc resources for the user manual, hacking guide, & migration guide are built using AsciiDoctor. We could substantially improve the user experience by moving to [Antora|https://antora.org/]. Antora is well featured, well supported, and used in many open source projects. The benefits of migrating include:
> * Overall better formatting which improves readability
> * Tighter integration between all the guides
> * Automatic incorporation of multiple versions during the build phase
> ** Automatic selection of "latest"
> ** Automatic warning when browsing older docs
> * Searchability!
> * Simpler theme customization
> * Easier navigation thanks to better contextual menus, bread-crumbs, etc.
> * Easier for folks to submit fixes (i.e., via the "Edit this Page" link)
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@artemis.apache.org
For additional commands, e-mail: issues-help@artemis.apache.org