Same as Ufuk (non-binding) In general, docs pages are great "first commits" to leave out there as newb-issues.
Also though, worth checking how often people use the page (e.g. GA) 3rd option: add a `.bu` to AWS/GCE pages and open a JIRA ticket to fix them (and put a readme explaining why they are in `.bu` status (which should prevent the build from picking them up), in essence, you're commenting them all out until someone can come around fix them. Further, I would put a holder page in their place that says something like, "This works, but we need someone to update the docs- check out JIRA XXXX for more details", might get someone to clean em up sooner w a little advertising. Just my .02 I can't do full overhauls right now, but I could execute the "comment out" option if it comes to that. On Thu, Dec 5, 2019 at 6:35 AM Ufuk Celebi <u...@apache.org> wrote: > +1 to drop the MapR page. > > For the other two I'm +0. I fully agree that the linked AWS and GCE pages > are in bad shape and don't relate to a component developed by the > community. Do we have any numbers from Google Analytics on how popular > those pages are? If they are somewhat popular, I would prefer to "fix them" > to be good starting points for users in those environments (probably by > boiling them down to saying something simple such as "You should use > FileSystem [...] and point it to [...]."). > > – Ufuk > > On Thu, Dec 5, 2019 at 10:49 AM Till Rohrmann <trohrm...@apache.org> > wrote: > > > > If the community cannot manage to keep the vendor-specific documentation > up > > to date, then I believe it is better to drop it. Hence +1 for the > proposal. > > > > Cheers, > > Till > > > > On Tue, Dec 3, 2019 at 3:12 PM Aljoscha Krettek <aljos...@apache.org> > wrote: > > > > > +1 > > > > > > Best, > > > Aljoscha > > > > > > > On 2. Dec 2019, at 18:38, Konstantin Knauf <konstan...@ververica.com > > > > > wrote: > > > > > > > > +1 from my side to drop. > > > > > > > > On Mon, Dec 2, 2019 at 6:34 PM Seth Wiesman <sjwies...@gmail.com> > wrote: > > > > > > > >> Hi all, > > > >> > > > >> I'd like to discuss dropping vendor-specific deployment > documentation > > > from > > > >> Flink's official docs. To be clear, I am *NOT* suggesting we drop > any of > > > >> the filesystem documentation, but the following three pages. > > > >> > > > >> AWS: > > > >> > > > >> > > > > > https://ci.apache.org/projects/flink/flink-docs-master/ops/deployment/aws.html > > > >> Google Compute Engine: > > > >> > > > >> > > > > > https://ci.apache.org/projects/flink/flink-docs-master/ops/deployment/gce_setup.html > > > >> MapR: > > > >> > > > >> > > > > > https://ci.apache.org/projects/flink/flink-docs-master/ops/deployment/mapr_setup.html > > > >> > > > >> Unlike the filesystems, these docs do not refer to components > > > maintained by > > > >> the Apache Flink community, but external commercial services and > > > products. > > > >> None of these pages are well maintained and I do not think the > > > open-source > > > >> community can reasonably be expected to keep them up to date. In > > > >> particular, > > > >> > > > >> > > > >> - The AWS page contains sparse information and mostly just links > to > > > the > > > >> official EMR docs. > > > >> - The Google Compute Engine page is out of date and the commands > do > > > not > > > >> work. > > > >> - MapR contains some relevant information but the community has > > > already > > > >> dropped the MapR filesystem so I am not sure that deployment would > > > work > > > >> (I > > > >> have not tested). > > > >> > > > >> There is also a larger question of which vendor products should be > > > included > > > >> and which should not. That is why I would like to suggest dropping > these > > > >> pages and referring users to vendor maintained documentation > whenever > > > they > > > >> are using one of these services. > > > >> > > > >> Seth Wiesman > > > >> > > > > > > > > > > > > -- > > > > > > > > Konstantin Knauf | Solutions Architect > > > > > > > > +49 160 91394525 > > > > > > > > > > > > Follow us @VervericaData Ververica <https://www.ververica.com/> > > > > > > > > > > > > -- > > > > > > > > Join Flink Forward <https://flink-forward.org/> - The Apache Flink > > > > Conference > > > > > > > > Stream Processing | Event Driven | Real Time > > > > > > > > -- > > > > > > > > Ververica GmbH | Invalidenstrasse 115, 10115 Berlin, Germany > > > > > > > > -- > > > > Ververica GmbH > > > > Registered at Amtsgericht Charlottenburg: HRB 158244 B > > > > Managing Directors: Timothy Alexander Steinert, Yip Park Tung Jason, > Ji > > > > (Tony) Cheng > > > > > > >
