Thanks a lot, Matthias! I created an actual "FLIP-Template" based on the
template you copied over.

I propose to change the list of public interfaces to this:

All of the following are public interfaces that people build around:
 - DataStream and DataSet API, including classes related to that, such as
StreamExecutionEnvironment
 - Classes marked with the @Public annotation
 - On-disk binary formats, such as checkpoints/savepoints
 - Configuration
 - Monitoring

Cheers,
Aljoscha

On Fri, 8 Jul 2016 at 13:49 Matthias J. Sax <mj...@apache.org> wrote:

> Done.
>
> I replaced KIP -> FLIP and Kafka -> Flink. Still there are some things
> we need to rework. Please have a look and propose changes.
>
>
> https://cwiki.apache.org/confluence/display/FLINK/Flink+Improvement+Proposals
>
> Same for FLIP Template
>
> https://cwiki.apache.org/confluence/display/FLINK/FLIP+Template
>
>
> -Matthias
>
> On 07/08/2016 09:56 AM, Aljoscha Krettek wrote:
> > Hi,
> > I got this reply from one of the Kafka committers:
> >
> > Thanks for sharing your intention to use a process similar to our KIP
> >
> > process. You are more than welcome to copy the structures and docs that
> we
> >
> > have for the KIP process. :)
> >
> > Ismael
> >
> >
> > So it seems we're good to go. @Matthias, since you are a Kafka
> contributor,
> > could you maybe copy the relevant docs from the Kafka wiki to our wiki?
> The
> > source for this page:
> >
> https://cwiki.apache.org/confluence/display/KAFKA/Kafka+Improvement+Proposals
> > and
> > the KIP template that is referenced there. If you want, I can take it
> from
> > there and adapt it to Flink and then let everyone discuss it again.
> >
> >
> > Cheers,
> >
> > Aljoscha
> >
> > On Thu, 7 Jul 2016 at 11:38 Aljoscha Krettek <aljos...@apache.org>
> wrote:
> >
> >> I'll reach out to the Kafka community and ask if it's ok for us to
> "steal"
> >> their process for this.
> >>
> >> On Thu, 7 Jul 2016 at 11:36 Aljoscha Krettek <aljos...@apache.org>
> wrote:
> >>
> >>> @Matthias: Yes, this is the reason why I like the KIP process and why I
> >>> said "The problem with these is that a) the comments on the Google
> Docs are
> >>> not reflected in Jira and the mailing list. There has been some very
> active
> >>> discussion on some of the docs that most people would never notice.".
> >>>
> >>> On Thu, 7 Jul 2016 at 11:28 Robert Metzger <rmetz...@apache.org>
> wrote:
> >>>
> >>>> I also like the proposal. I think its an issue that Google Docs
> comments
> >>>> are not reflected within ASF infra. Therefore, I'm +1 on discussing
> the
> >>>> proposals on the mailing list.
> >>>>
> >>>> I agree that we need to clean up our wiki.
> >>>>
> >>>> On Thu, Jul 7, 2016 at 10:58 AM, Matthias J. Sax <mj...@apache.org>
> >>>> wrote:
> >>>>
> >>>>> Just to point out one thing about Kafka KIPs and using the project
> >>>> wiki:
> >>>>>
> >>>>> The wiki contains the current state of the proposal, while the
> >>>>> discussion is covered over the dev-mailing list. IMHO, this makes a
> lot
> >>>>> of sense, as people tend to follow the mailing list but not wiki
> >>>>> changes. Furthermore, the mailing list tracks the whole discussion
> >>>>> history, while the proposal is kept in a clean state and thus easy to
> >>>> read.
> >>>>>
> >>>>> -Matthias
> >>>>>
> >>>>>
> >>>>> On 07/06/2016 10:09 PM, Aljoscha Krettek wrote:
> >>>>>> Jip, that's why I referenced the Kafka process which is also in
> their
> >>>>> wiki.
> >>>>>>
> >>>>>> On Wed, 6 Jul 2016 at 21:01 Stephan Ewen <se...@apache.org> wrote:
> >>>>>>
> >>>>>>> Yes, big +1
> >>>>>>>
> >>>>>>> I had actually talked about the same thing with some people as
> well.
> >>>>>>>
> >>>>>>> I am currently sketching a few FLIPs for things, like improvements
> >>>> to
> >>>>> the
> >>>>>>> Yarn/Mesos/Kubernetes integration
> >>>>>>>
> >>>>>>>
> >>>>>>> One thing we should do here is to actually structure the wiki a bit
> >>>> to
> >>>>> make
> >>>>>>> it easier to find information and proposals.
> >>>>>>>
> >>>>>>>
> >>>>>>>
> >>>>>>>
> >>>>>>> On Wed, Jul 6, 2016 at 4:24 PM, Ufuk Celebi <u...@apache.org>
> wrote:
> >>>>>>>
> >>>>>>>> Hey Aljoscha,
> >>>>>>>>
> >>>>>>>> thanks for this proposal. I've somehow missed it last week. I like
> >>>> the
> >>>>>>>> idea very much and agree with your assessment about the problems
> >>>> with
> >>>>>>>> the Google Doc approach.
> >>>>>>>>
> >>>>>>>> Regarding the process: I'm also in favour of adopting it from
> >>>> Kafka. I
> >>>>>>>> would not expect any problems with this, but we can post a quick
> >>>> note
> >>>>>>>> to their ML.
> >>>>>>>>
> >>>>>>>> @Matthias: The name works for me. ;-)
> >>>>>>>>
> >>>>>>>> – Ufuk
> >>>>>>>>
> >>>>>>>> On Tue, Jun 28, 2016 at 10:19 PM, Matthias J. Sax <
> >>>> mj...@apache.org>
> >>>>>>>> wrote:
> >>>>>>>>> FLIP ?? Really? :D
> >>>>>>>>>
> >>>>>>>>> http://www.maya.tv/en/character/flip
> >>>>>>>>>
> >>>>>>>>> -Matthias
> >>>>>>>>>
> >>>>>>>>>
> >>>>>>>>> On 06/28/2016 06:26 PM, Aljoscha Krettek wrote:
> >>>>>>>>>> I'm proposing to add a formal process for how we deal with
> >>>> (major)
> >>>>>>>>>> improvements to Flink and design docs. This has been mentioned
> >>>>> several
> >>>>>>>>>> times recently but we never took any decisive action to actually
> >>>>>>>> implement
> >>>>>>>>>> such a process so here we go.
> >>>>>>>>>>
> >>>>>>>>>> Right now, we have Jira issues and we sometimes we have design
> >>>> docs
> >>>>>>>> that we
> >>>>>>>>>> keep in Google Docs. Jamie recently added links to those that he
> >>>>> could
> >>>>>>>> find
> >>>>>>>>>> on the mailing list to the Flink wiki:
> >>>>>>>>>>
> >>>> https://cwiki.apache.org/confluence/display/FLINK/Apache+Flink+Home.
> >>>>>>>> The
> >>>>>>>>>> problem with these is that a) the comments on the Google Docs
> >>>> are not
> >>>>>>>>>> reflected in Jira and the mailing list. There has been some very
> >>>>>>> active
> >>>>>>>>>> discussion on some of the docs that most people would never
> >>>> notice.
> >>>>>>> The
> >>>>>>>>>> community therefore might seem less active than it actually is.
> >>>> b)
> >>>>> the
> >>>>>>>>>> documents are not very discoverable, if we had a clearly defined
> >>>>> place
> >>>>>>>>>> where we put them and also prominently link to this on the Flink
> >>>>>>>> homepage
> >>>>>>>>>> this would greatly help people that try to find out about
> current
> >>>>>>>>>> developments.
> >>>>>>>>>>
> >>>>>>>>>> Kafka has a process like this:
> >>>>>>>>>>
> >>>>>>>>
> >>>>>>>
> >>>>>
> >>>>
> https://cwiki.apache.org/confluence/display/KAFKA/Kafka+Improvement+Proposals
> >>>>>>>> .
> >>>>>>>>>> They call it KIP, for Kafka Improvement Proposal. We could
> either
> >>>>>>> adapt
> >>>>>>>>>> this for Flink or come up with our own process. Doing the former
> >>>>> would
> >>>>>>>> save
> >>>>>>>>>> us a lot of time and I don't think the Kafka community would
> >>>> mind us
> >>>>>>>>>> copying their process. The subject also hints at this, our
> >>>> process
> >>>>>>>> could be
> >>>>>>>>>> called FLIP, for Flink Improvement Proposal.
> >>>>>>>>>>
> >>>>>>>>>> What do you think? Feedback is highly welcome. :-)
> >>>>>>>>>>
> >>>>>>>>>> Cheers,
> >>>>>>>>>> Aljoscha
> >>>>>>>>>>
> >>>>>>>>>
> >>>>>>>>
> >>>>>>>
> >>>>>>
> >>>>>
> >>>>>
> >>>>
> >>>
> >
>
>

Reply via email to