+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/ >> >
