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