Can't we use something like the "{{ site.release_latest }}" tag used in
Website docs ?
https://github.com/apache/beam/blob/master/website/src/get-started/quickstart-java.mdOn Wed, May 6, 2020 at 11:06 AM Robert Bradshaw <[email protected]> wrote: > E.g. if I google "apache beam javadoc", the first link is for version > 2.1.0 (no, that's not 2.21.0), the second for a (raw-looking) > directory index of javadocs by version, the third for Beam 2.5.0, and > the fourth for a class in 2.2.0. > > > On Wed, May 6, 2020 at 11:02 AM Robert Bradshaw <[email protected]> > wrote: > > > > One problem is that there's no way to link to the "latest" version of > > the docs, or toggle between them. What links to docs we have are > > pointing to specific (often very old or out of date) docs. If we can > > solve this that'd make me more in favor of this proposal. > > > > On Wed, May 6, 2020 at 9:23 AM Kenneth Knowles <[email protected]> wrote: > > > > > > +1 > > > > > > On Wed, May 6, 2020 at 9:11 AM Alexey Romanenko < > [email protected]> wrote: > > >> > > >> +1 It would make more sense to point to the latest release Javadoc of > IO > > >> > > >> On 6 May 2020, at 06:56, Chamikara Jayalath <[email protected]> > wrote: > > >> > > >> +1 for linking to the more readable version. > > >> > > >> - Cham > > >> > > >> On Tue, May 5, 2020, 9:26 AM Brian Hulette <[email protected]> > wrote: > > >>> > > >>> +1 for doc links instead of code. I think from a user perspective > the code link is effectively the same as javadoc/pydoc since they'll just > peruse the docstrings, except it's harder to read and reflects the behavior > at HEAD, not at any release. > > >>> > > >>> Brian > > >>> > > >>> On Mon, May 4, 2020 at 6:21 PM Pablo Estrada <[email protected]> > wrote: > > >>>> > > >>>> Hi all, > > >>>> I just noted that in our Built-in IOs page[1], we tend to link to > the code for the IOs that we mention. > > >>>> > > >>>> I think it would be better to link to the Javadoc or the Pydoc for > those IOs instead. Thoughts? > > >>>> Best > > >>>> -P. > > >>>> > > >>>> [1] https://beam.apache.org/documentation/io/built-in/ > > >> > > >> >
