Thanks Timo for taking this over :-)
On Wed, Aug 23, 2017 at 10:51 AM, Timo Walther <twal...@apache.org> wrote: > I had a offline discussion with Ufuk. I looked into the docs build scripts > recently, I can take care of removing the old docs. There other issues that > need to be fixed before the next release as well: > > - Drop docs < 1.0 > - Make Javadocs with Scala build again > - Build all docs >= 1.0 again (esp. to add the outdated wanring) > > Regards, > Timo > > Am 23.08.17 um 08:46 schrieb Piotr Nowojski: > >> +1 >> >> Is there a way to serve “current” docs under some permanent link, showing >> docs from whatever is the latest release? Maybe such docs could be indexed >> by the google and ranked higher then any particular release mitigating this >> issue for the future? >> >>> On Aug 22, 2017, at 6:48 PM, Till Rohrmann <trohrm...@apache.org> wrote: >>> >>> +1 >>> >>> On Tue, Aug 22, 2017 at 6:16 PM, Stefan Richter >>> <s.rich...@data-artisans.com >>>> >>>> wrote: >>>> +1 >>>> >>>>> Am 22.08.2017 um 18:07 schrieb Robert Metzger <rmetz...@apache.org>: >>>>> >>>>> Please go ahead +1 >>>>> >>>>> Thank you for taking care! >>>>> >>>>> On Tue, Aug 22, 2017 at 6:02 PM, Aljoscha Krettek <aljos...@apache.org> >>>>> wrote: >>>>> >>>>>> +1 >>>>>>> >>>>>>> On 22. Aug 2017, at 18:01, Stephan Ewen <se...@apache.org> wrote: >>>>>>> >>>>>>> +1 >>>>>>> >>>>>>> On Tue, Aug 22, 2017 at 5:58 PM, Ufuk Celebi <u...@apache.org> 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 <u...@apache.org> >>>>>>>> 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 >>>> >>>> in >>>>>>>>> >>>>>>>>> that PR too :-) >>>>>>>>> >>>>>>>>> >>>>>>>>> On Wed, Aug 16, 2017 at 6:56 PM, Ted Yu <yuzhih...@gmail.com> >>>>>>>>> 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.klou...@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 >>>>>>>>>>> (== 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 <u...@apache.org> 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 >>>> >>>> newer >>>>>>>>>>>> >>>>>>>>>>>> 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 >>>> >>>> the >>>>>>>>>>>> >>>>>>>>>>>> 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. >>>>>>>>>>>> >>>>>>>>>>>> – Ufuk >>>>>>>>>>>> >>>>>>>>>>>> PS: I've created an issue to improve the visibility of the >>>> >>>> outdated >>>>>>>>>>>> >>>>>>>>>>>> warning here https://issues.apache.org/jira/browse/FLINK-7462. I >>>>>>>> >>>>>>>> will >>>>>>>>>>>> >>>>>>>>>>>> only apply this to versions >= 1.0 for now. >>>>>>>>>>> >>>>>>>>>>> >>>>>> >>>> >
