Hi Everyone,
@Alexey, I think this is a great idea, I'd like to understand more of the motivation behind having all the designs doc under a single page. In my opinion it could become a challenge to maintain a page, so knowing what you want to accomplish could help us think of alternative solutions? On Wed, 23 May 2018 at 14:08, Daniel Oliveira <danolive...@google.com> wrote: > +1 to web site page (not Google Doc). > > Definitely agree that a common entry point would be excellent. I don't > like the idea of the Google Doc so much because it's not very good for > having changes reviewed and keeping track of who added what, unlike Github. > Adding an entry to the list in the website would require reviews and leave > behind a commit history, which I think is important for an > authoritative source like this. > > PS: I also have a doc I proposed that I didn't see in the lists: > https://s.apache.org/beam-runner-api-combine-model > > On Wed, May 23, 2018 at 12:52 PM Lukasz Cwik <lc...@google.com> wrote: > >> +1, Thanks for picking this up Alexey >> >> On Wed, May 23, 2018 at 10:41 AM Huygaa Batsaikhan <bat...@google.com> >> wrote: >> >>> +1. That is great, Alexey. Robin and I are working on documenting some >>> missing pieces of Java SDK. We will let you know when we create polished >>> documents. >>> >>> On Wed, May 23, 2018 at 9:28 AM Ismaël Mejía <ieme...@gmail.com> wrote: >>> >>>> +1 and thanks for volunteering for this Alexey. >>>> We really need to make this more accesible. >>>> On Wed, May 23, 2018 at 6:00 PM Alexey Romanenko < >>>> aromanenko....@gmail.com> >>>> wrote: >>>> >>>> > Joseph, Eugene - thank you very much for the links! >>>> >>>> > All, regarding one common entry point for all design documents. Could >>>> we >>>> just have a dedicated page on Beam web site with a list of links to >>>> every >>>> proposed document? Every entry (optionally) might contain, in addition, >>>> short abstract and list of author(s). In this case, it would be easily >>>> searchable and available for those who are interested in this. >>>> >>>> > In the same time, using a Google doc for writing/discussing the >>>> documents >>>> seems more than reasonable since it’s quite native and easy to use. I >>>> only >>>> propose to have a common entry point to fall of them. >>>> >>>> > If this idea looks feasible, I’d propose myself to collect the links >>>> to >>>> already created documents, create such page and update this list in the >>>> future. >>>> >>>> > WBR, >>>> > Alexey >>>> >>>> > On 22 May 2018, at 21:34, Eugene Kirpichov <kirpic...@google.com> >>>> wrote: >>>> >>>> > Making it easier to manage indeed would be good. Could someone from >>>> PMC >>>> please add the following documents of mine to it? >>>> >>>> > SDF related documents: >>>> > http://s.apache.org/splittable-do-fn >>>> > http://s.apache.org/sdf-via-source >>>> > http://s.apache.org/textio-sdf >>>> > http://s.apache.org/beam-watch-transform >>>> > http://s.apache.org/beam-breaking-fusion >>>> >>>> > Non SDF related: >>>> > http://s.apache.org/context-fn >>>> > http://s.apache.org/fileio-write >>>> >>>> > A suggestion: maybe we can establish a convention to send design >>>> document >>>> proposals to dev+desi...@beam.apache.org? Does the Apache mailing list >>>> management software support this kind of stuff? Then they'd be quite >>>> easy >>>> to find and filter. >>>> >>>> > On Tue, May 22, 2018 at 10:57 AM Kenneth Knowles <k...@google.com> >>>> wrote: >>>> >>>> >> It is owned by the Beam PMC collectively. Any PMC member can add >>>> things >>>> to it. Ideas for making it easy to manage are welcome. >>>> >>>> >> Probably easier to have a markdown file somewhere with a list of >>>> docs so >>>> we can issue and review PRs. Not sure the web site is the right place >>>> for >>>> it - we have a history of porting docs to markdown but really that is >>>> high >>>> overhead and users/community probably don't gain from it so much. Some >>>> have >>>> suggested a wiki. >>>> >>>> >> Kenn >>>> >>>> >> On Tue, May 22, 2018 at 10:22 AM Scott Wegner <sweg...@google.com> >>>> wrote: >>>> >>>> >>> Thanks for the links. Any details on that Google drive folder? Who >>>> maintains it? Is it possible for any contributor to add their design >>>> doc? >>>> >>>> >>> On Mon, May 21, 2018 at 8:15 AM Joseph PENG < >>>> josephtengp...@gmail.com> >>>> wrote: >>>> >>>> >>>> Alexey, >>>> >>>> >>>> I do not know where you can find all design docs, but I know a blog >>>> that has collected some of the major design docs. Hope it helps. >>>> >>>> >>>> https://wtanaka.com/beam/design-doc >>>> >>>> >>>> >>>> https://drive.google.com/drive/folders/0B-IhJZh9Ab52OFBVZHpsNjc4eXc >>>> >>>> >>>> On Mon, May 21, 2018 at 9:28 AM Alexey Romanenko < >>>> aromanenko....@gmail.com> wrote: >>>> >>>> >>>>> Hi all, >>>> >>>> >>>>> Is it possible to obtain somewhere a list of all proposals / >>>> prototype documents that have been published as a technical / design >>>> documents for new features? I have links to only some of them (found in >>>> mail list discussions by chance) but I’m not aware of others. >>>> >>>> >>>>> If yes, could someone share it or point me out where it is >>>> located in >>>> case if I missed this? >>>> >>>> >>>>> If not, don’t you think it would make sense to have such index of >>>> these documents? I believe it can be useful for Beam contributors since >>>> these proposals contain information which is absent or not so detailed >>>> on >>>> Beam web site documentation. >>>> >>>> >>>>> WBR, >>>> >>>>> Alexey >>>> >>>
