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