Along these lines, it would help to add a sitemap (and the robots.txt required to reference it) for flink.apache.org and ci.apache.org (for /projects/flink)
You can see what Tomcat did along these lines - http://tomcat.apache.org/robots.txt references http://tomcat.apache.org/sitemap.xml, which is a sitemap index file pointing to http://tomcat.apache.org/sitemap-main.xml By doing this, you can emphasize more recent versions of docs. There are other benefits, but reducing poor Google search results (to me) is the biggest win. E.g. https://www.google.com/search?q=flink+reducingstate <https://www.google.com/search?q=flink+reducingstate> (search on flink reducing state) shows the 1.3 Javadocs (hit #1), master (1.6-SNAPSHOT) Javadocs (hit #2), and then many pages of other results. Whereas the Javadocs for 1.5 <https://ci.apache.org/projects/flink/flink-docs-release-1.5/api/java/org/apache/flink/api/common/state/ReducingState.html> and 1.4 <https://ci.apache.org/projects/flink/flink-docs-release-1.4/api/java/org/apache/flink/api/common/state/ReducingState.html> are nowhere to be found. Thoughts? — Ken > On Jun 5, 2018, at 9:46 AM, Stephan Ewen <se...@apache.org> wrote: > > Big +1 to this! > > I would like to contribute to this effort and help strengthen the way Flink > presents itself. > > > On Tue, Jun 5, 2018 at 11:56 AM, Fabian Hueske <fhue...@gmail.com> wrote: > >> Hi everybody, >> >> I've opened a PR [1] that reworks parts of the Flink website ( >> flink.apache.org). >> >> My goal is to improve the structure of the website and provide more >> valuable information about the project and the community. >> >> A visitor (who doesn't know Flink yet) should be able to easily find >> answers to the following questions: >> * What is Apache Flink? >> * Does it address my use case? >> * Is it credible? / Who is using it? >> >> To achieve that, I have: >> * Rework menu structure into three sections to address different audiences: >> - Potential users (see above) >> - Users >> - Contributors >> * Reworked start page: updated the figure, added a feature grid, moved >> "Powered By" section up >> * Replaced Features page by more detailed "What is Flink?" pages >> * Reworked "Use Cases" page >> >> The PR should also improve the page for users who have questions about >> Flink or need help. >> For that, I have: >> * Added a "Getting Help" page (less content than the detailed community >> page) >> * Removed IRC channel info >> >> Please give feedback, suggest improvements, and proof read the new texts. >> >> Thanks, Fabian >> >> [1] https://github.com/apache/flink-web/pull/109 >> -------------------------------------------- http://about.me/kkrugler +1 530-210-6378
