This got me thinking about who is the intended audience for the JavaDoc.
It's not for folks working on the broker directly since they already have
the source code and can read the JavaDoc directly. It's not for folks using
JMS, AMQP, OpenWire, MQTT, or STOMP since the JavaDoc doesn't apply to any
That would also be nicer than having them all, though still the same
amount of work on updates. Its what the 5.x docs at least aim to do
(typically out of date).
Another middle ground might be just automating the release details
linking to the zips on maven-central, meaning its still/actually
On Wed, 28 Sept 2022 at 19:12, Étienne Hossack wrote:
>
> -1
>
> Reasons to keep:
> * It's useful to be able to link a specific line/method in the javadoc when
> explaining something to someone through the use of a URL
> * It's nice to be able to navigate the source code in your browser, if say
*if* we keep the javadoc, I would like to only keep the latest
version I don't see much point on keeping 24+ versions of the
javadocs
On Wed, Sep 28, 2022 at 2:12 PM Étienne Hossack wrote:
>
> -1
>
> Reasons to keep:
> * It's useful to be able to link a specific line/method in the javadoc
Personally I read most javadocs in the IDE these days whilst using the
thing in question, with IDEs grabbing it (/the source) from Maven
Central as you say. For more specific things about the actual client
or broker however I tend to link into their source on github these
days. I dont really ever
-1
Reasons to keep:
* It's useful to be able to link a specific line/method in the javadoc when
explaining something to someone through the use of a URL
* It's nice to be able to navigate the source code in your browser, if say your
IDE is having issues and you can't correctly navigate to docs
Can we stop publishing javadocs on the ActiveMQ Website for artemis?
I see no point on publishing it as they are available in Maven.
My vote is to completely remove it.
So, if you agree with me, please respond with
+1 Yes, stop publishing javadocs for ActiveMQ Artemis on the website
and keep