Many projects and also JDK adopts the approach of version selector in the Javadoc so I think people are accustomed to searching for the right documentation.
I don't really mind if we follow this approach or not but if it simplifies the automation process maybe this would be another advantage. Best, Stamatis On Tue, Jul 16, 2019, 7:53 AM Vladimir Sitnikov <[email protected]> wrote: > Francis> I've been burnt in the past where generated documentation is for > master > Francis> and not the latest release, causing some confusion. > > On contrary, it is better when the documentation has version selector, so > one could pick an appropriate version. > Then "snapshot" documentation is good for the review purposes. > > The documentation for "past" releases is helpful as well. > > Vladimir >
