Return-Path: X-Original-To: archive-asf-public@cust-asf.ponee.io Delivered-To: archive-asf-public@cust-asf.ponee.io Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by cust-asf.ponee.io (Postfix) with SMTP id E3CA116730A for ; Tue, 22 Aug 2017 18:07:30 +0200 (CEST) Received: (qmail 80126 invoked by uid 500); 22 Aug 2017 16:07:29 -0000 Mailing-List: contact dev-help@flink.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@flink.apache.org Delivered-To: mailing list dev@flink.apache.org Received: (qmail 80115 invoked by uid 99); 22 Aug 2017 16:07:29 -0000 Received: from mail-relay.apache.org (HELO mail-relay.apache.org) (140.211.11.15) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 22 Aug 2017 16:07:29 +0000 Received: from mail-yw0-f175.google.com (mail-yw0-f175.google.com [209.85.161.175]) by mail-relay.apache.org (ASF Mail Server at mail-relay.apache.org) with ESMTPSA id 935001A002B for ; Tue, 22 Aug 2017 16:07:27 +0000 (UTC) Received: by mail-yw0-f175.google.com with SMTP id s143so110802748ywg.1 for ; Tue, 22 Aug 2017 09:07:27 -0700 (PDT) X-Gm-Message-State: AHYfb5hsKwLTYwit4RbJ+7y4ngvCbrSJoZrzTMdygr76WAL3BEwQbPwG p7YMA5asIxdfDgfytqYTITPzpKiKIQ== X-Received: by 10.129.154.10 with SMTP id r10mr980700ywg.390.1503418047148; Tue, 22 Aug 2017 09:07:27 -0700 (PDT) MIME-Version: 1.0 Received: by 10.37.207.83 with HTTP; Tue, 22 Aug 2017 09:07:06 -0700 (PDT) In-Reply-To: References: <3FCABB07-E692-4CCE-9E46-148987B05630@data-artisans.com> From: Robert Metzger Date: Tue, 22 Aug 2017 18:07:06 +0200 X-Gmail-Original-Message-ID: Message-ID: Subject: Re: [DISCUSS] Stop serving docs for Flink version prior to 1.0 To: "dev@flink.apache.org" Cc: Ufuk Celebi Content-Type: multipart/alternative; boundary="94eb2c0b8438a6422b055759caf4" --94eb2c0b8438a6422b055759caf4 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable Please go ahead +1 Thank you for taking care! On Tue, Aug 22, 2017 at 6:02 PM, Aljoscha Krettek wrote: > +1 > > On 22. Aug 2017, at 18:01, Stephan Ewen wrote: > > > > +1 > > > > On Tue, Aug 22, 2017 at 5:58 PM, Ufuk Celebi wrote: > > > >> Quick update: If there are no objections, I will start looking into > >> how to stop serving the docs for Flink < 1.0 after tomorrow. > >> > >> > >> On Wed, Aug 16, 2017 at 10:45 PM, Ufuk Celebi wrote: > >>> Thanks for your early feedback Kostas and Ted. > >>> > >>> @Kostas: I have a proposal for a more obvious warning here: > >>> https://github.com/apache/flink/pull/4553 Would appreciate comments i= n > >>> that PR too :-) > >>> > >>> > >>> On Wed, Aug 16, 2017 at 6:56 PM, Ted Yu wrote: > >>>> Without any upgrade path, the old versions are not useful. > >>>> > >>>> +1 on redirecting doc to stable release(s). > >>>> > >>>> On Wed, Aug 16, 2017 at 9:46 AM, Kostas Kloudas < > >> k.kloudas@data-artisans.com > >>>>> wrote: > >>>> > >>>>> Hi Ufuk, > >>>>> > >>>>> +1 > >>>>> > >>>>> I think that this is a nice change! > >>>>> Thanks Ufuk for opening the discussion. > >>>>> > >>>>> I think that broken/redirect links are not an issue, > >>>>> as either way the information provided is far outdated > >>>>> (=3D=3D wrong). > >>>>> > >>>>> As for the warning, we cannot put it in the header instead > >>>>> of the footer? Sth like, this page may contain outdated info, > >>>>> please refer to XXX for an updated version. > >>>>> > >>>>> Kostas > >>>>> > >>>>>> On Aug 16, 2017, at 6:02 PM, Ufuk Celebi wrote: > >>>>>> > >>>>>> Hey devs, > >>>>>> > >>>>>> I would like to stop serving the documentation for all Flink > versions > >>>>>> prior to 1.0. > >>>>>> > >>>>>> Do you have any concerns about this? > >>>>>> > >>>>>> These Flink versions are very old without any upgrade path to newe= r > >>>>>> versions but they still get a lot of traffic and most new users > don't > >>>>>> realize that they are looking at a very outdated docs page. > >>>>>> > >>>>>> Even with a stronger warning about being outdated, I don't see a > >> point > >>>>>> in serving them. > >>>>>> > >>>>>> If we choose to do this, I would redirect these ancient pages to t= he > >>>>>> docs of the latest stable release and update the release process > Wiki > >>>>>> page to update those redirects etc. > >>>>>> > >>>>>> This will mean that some links in old StackOverflow questions and > the > >>>>>> mailing list archives will be broken/redirected. If you have > concerns > >>>>>> about this, please raise your voice in this thread. > >>>>>> > >>>>>> =E2=80=93 Ufuk > >>>>>> > >>>>>> PS: I've created an issue to improve the visibility of the outdate= d > >>>>>> warning here https://issues.apache.org/jira/browse/FLINK-7462. I > >> will > >>>>>> only apply this to versions >=3D 1.0 for now. > >>>>> > >>>>> > >> > > --94eb2c0b8438a6422b055759caf4--