[
https://issues.apache.org/jira/browse/ARTEMIS-4383?focusedWorklogId=874412&page=com.atlassian.jira.plugin.system.issuetabpanels:worklog-tabpanel#worklog-874412
]
ASF GitHub Bot logged work on ARTEMIS-4383:
-------------------------------------------
Author: ASF GitHub Bot
Created on: 03/Aug/23 12:13
Start Date: 03/Aug/23 12:13
Worklog Time Spent: 10m
Work Description: clebertsuconic commented on PR #4573:
URL:
https://github.com/apache/activemq-artemis/pull/4573#issuecomment-1663872163
@gemmellr I didn't think this was breaking the build. I thought it would be
ok to keep changing on main and collaborate on main after the merge. Sorry if
I caused an issue there.
Issue Time Tracking
-------------------
Worklog Id: (was: 874412)
Time Spent: 2h (was: 1h 50m)
> Migrate user docs to AsciiDoc
> -----------------------------
>
> Key: ARTEMIS-4383
> URL: https://issues.apache.org/jira/browse/ARTEMIS-4383
> Project: ActiveMQ Artemis
> Issue Type: Task
> Reporter: Justin Bertram
> Assignee: Justin Bertram
> Priority: Major
> Time Spent: 2h
> Remaining Estimate: 0h
>
> Markdown, which is currently used for user-facing documentation, is good for
> a lot of things. However, it's not great for the kind of complex
> documentation we have and our need to produce both multi-page HTML and
> single-page PDF output via Maven.
> Markdown lacks features which would make the documentation easier to read,
> easier to navigate, and just look better overall.
> The current tool-chain uses [honkit|https://github.com/honkit/honkit] and a
> tool called [Calibre|https://manual.calibre-ebook.com/]. Hokit is written in
> TypeScript and is installed via NPM. Calibre is a _native_ tool so it must be
> installed via an OS-specific package manager. All this complexity makes
> building, releasing, uploading, etc. a pain.
> AsciiDoc is relatively simple like Markdown, but it has more features for
> presentation and navigation not to mention Java-based Maven tooling to
> generate both HTML and PDF. Migrating will improve both the appearance of the
> documentation as well as the processes to generate and upload it.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
