Hi, Thanks a lot for raising the discussion @Stephan. +1 to increase the visibilities of the Stateful Functions.
Another option I'm think is adding a section(named Stateful Functions or Flink Projects?) under the "Latest Blog Posts". The advantage is we can add a picture and some descriptions here. A picture may attract more attention from the users when he/she visit the website. The picture can be the same one in [1]. In the future, if we have multiple Flink individual projects, we can also turn the section into a Table list to expose all of them. What do you think? Best, Hequn [1] https://ci.apache.org/projects/flink/flink-statefun-docs-master/ On Tue, Mar 10, 2020 at 11:13 PM Tzu-Li (Gordon) Tai <tzuli...@apache.org> wrote: > +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 > > > > > >
