+1 On Wed, May 6, 2020 at 9:11 AM Alexey Romanenko <aromanenko....@gmail.com> 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 <chamik...@google.com> wrote: > > +1 for linking to the more readable version. > > - Cham > > On Tue, May 5, 2020, 9:26 AM Brian Hulette <bhule...@google.com> 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 <pabl...@google.com> 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/ >>> >> >
