gemmellr commented on PR #6182: URL: https://github.com/apache/artemis/pull/6182#issuecomment-3759680679
Not entirely sure about this consolidation direction as opposed to for example the reverse. The reason the new consoles docs were prepared outwith the Artemis build is that it can be used separately and it is released/updated separately, so it made sense that its docs should be able to be updated separately with its release as well. Arguably the broker docs that this change is overhauling should have been minimised further at that point and referenced out to the console docs (which would ideally also have been version-specific to facilitate that better, and perhaps in the console tree to be updated as changes are made to the console). Going this way, any time we make significant changes in a console release that should really be documented we then either have to just leave the console docs stale when releasing, or duplicate [some part of] this content back there to do it, since we couldnt update these docs on the site until after the next Artemis release (even if we did it manually out of band on the site, since they would then be incorrect for the current released Artemis version). For admittedly unusual reasons its taken us over 2 months since 1.4.0 was released, and in the end we skipped it for embedding with the broker, but will still be over a week between 1.5.0 and 2.50.0 going out. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
