+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] > <mailto:[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] > <mailto:[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/ > <https://beam.apache.org/documentation/io/built-in/>
