+1 on the suggestion to add "What is Stateful Functions" to the left navigation bar. That might also mean it would be nice to have a slight rework to the main image on the website, illustrating the use cases of Flink (this one [1]). On the image it does mention "Event-Driven Applications", but there's somewhat missing a more direct connection from that term to the Stateful Functions project.
As for what the "What is Stateful Functions?" button directs to, maybe that should point to a general concepts page. Initially, we can begin with the README contents on the project repo [2]. As for the actual Statefun documentation link [3], I think we should link that from an item in the "Documentation" pull-down list. One last thing to increase visibility of the Statefun project just a bit more: There's a "Flink on Github" button on the very bottom of the navigation bar. What do you think about adding a "Flink Stateful Functions on Github" button there as well? Cheers, Gordon [1] https://github.com/apache/flink-web/blob/asf-site/img/flink-home-graphic.png [2] https://github.com/apache/flink-statefun/blob/master/README.md [3] https://ci.apache.org/projects/flink/flink-statefun-docs-master/ On Tue, Mar 10, 2020 at 8:29 PM Yu Li <car...@gmail.com> wrote: > +1 on adding a "What is Stateful Functions" link below the "What is Apache > Flink" entry and integrating into the Flink docs gradually (instead of > hiding it behind until fully integrated). > > Best Regards, > Yu > > > On Tue, 10 Mar 2020 at 19:33, Stephan Ewen <se...@apache.org> wrote: > > > Hi all! > > > > I think it would be nice to mention Stateful Function on the Flink > website. > > At the moment, Stateful Functions is very hard to discover, and with the > > first release of it under Apache Flink, it would be a good time to change > > that. > > > > My proposal would be to add a "What is Stateful Functions?" below the > "What > > is Apache Flink" entry in the sidenav, and point it to > > https://ci.apache.org/projects/flink/flink-statefun-docs-master/ > > It is not ideal, yet, but it may serve as an intermediate solution until > we > > can make more involved attempt to rethink the website (for example to > also > > make SQL more prominent than it currently is). > > > > An alternative idea was to link it only from the docs, but this would be > a > > bit hidden, in my opinion. > > > > As a bit of background: > > - The Stateful Functions docs a are a separate doc tree at the moment, > > because the code (with the docs) is for now in a separate repository and > > separately versioned/releases. > > - The layout of the Stateful Functions docs is still in the > old/original > > format, from when it was an "outside Flink" project. > > - There are plans to migrate this to the same stack as the Flink docs > and > > make it look consistent, but it would be nice to have the docs available > > in the meantime already. > > > > Best, > > Stephan > > >
