+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 <[email protected]> wrote: > +1, Thanks for picking this up Alexey > > On Wed, May 23, 2018 at 10:41 AM Huygaa Batsaikhan <[email protected]> > 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 <[email protected]> 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 < >>> [email protected]> >>> 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 <[email protected]> >>> 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 [email protected]? 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 <[email protected]> >>> 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 <[email protected]> >>> 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 < >>> [email protected]> >>> 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 < >>> [email protected]> 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 >>> >>
