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.
