[docs] Change doc layout

[uce]

This is not completely done yet, but should suffice to give a feeling of the new layout. I think this is a good improvement over our current state.

• Changed layout (simple as possible)
• Fix broken version references in docs
• Update README
• Removed dead resources
• Reorganized content

Missing & coming up:

• Minor layout fixes (in comparison to the old version, this layout is way way simpler... it's essentially Bootstrap + minor customization)
• Content reorganization (too long documents, broken links etc.)

Note that a couple of links are changing with this update, but this is OK since it is only affecting the SNAPSHOT version of our docs.

[mxm]

👍 Looks much much better.

[ktzoumas]

This is one of the best project documentations that I have seen. Thanks a lot Ufuk for doing this! I would merge this as is.

Few minor thoughts I had when skimming through the docs:

• Perhaps we can find a better font for the code samples (not sure if applicable in this PR, perhaps this is a separate PR with a bunch of content refactoring)
• Was it not possible to have the navigation on the left or was it a conscious choice to have it on the right?
• Move Flink on Tez under Setup, since programming a job is the same, deployment is different?
• "Programming guides" seems a bit too narrow for what it contains (e.g., Local/Cluster execution). Perhaps rename to "Usage"?
• Not sure if the whole internals section is better fit for the docs or the wiki, but this is a ML discussion

[StephanEwen]

Is there a way a preview version uploaded somewhere, or a screenshot, or do I need to build the docs myself?

[mxm]

Very difficult to visualize all the changes with screenshots but it takes a few seconds to build the website. From your Flink source directory:

git fetch https://github.com/uce/incubator-flink.git new_docs && git checkout FETCH_HEAD && ./docs/build_docs.sh -p

Now open your browser at http://localhost:4000

[tillrohrmann]

I like the new docs layout :-)

[rmetzger]

It looks much better. I'm +1 for merging it immediately like this. Once its merged, I would propose to make some minor changes:

• The "beta" badge is not separated clearly enough from the rest of the text
• I'm missing some space at the end of each page
• It would be cool to have the version somewhere prominent (navbar?)

[hsaputra]

+1 Love it

[rmetzger]

The link to the "downloads page" is broken. It will point to http://ci.apache.org/projects/flink/flink-docs-master/downloads.html which doesn't exist.

[rmetzger]

I got this feedback from a Disqus comment of a user. I think its very valuable to have these comment boxes below the pages.

[rmetzger]

Why did you remove the Disqus comments from the pages?

[uce]

Addressed:

• Move Flink on Tez under Setup, since programming a job is the same, deployment is different? => moved to setup
• The "beta" badge is not separated clearly enough from the rest of the text => use badge and add to each beta page
• It would be cool to have the version somewhere prominent (navbar?) => Added to overview link
• I'm missing some space at the end of each page => OK
• Disqus
• Rebased and added Pyhton API links

Open:

• Not sure if the whole internals section is better fit for the docs or the wiki, but this is a ML discussion => Let's start a discussion on dev@
• Was it not possible to have the navigation on the left or was it a conscious choice to have it on the right? => It is possible, but it needed some hacking and I didn't want to spend more time. Will change it soonish.
• "Programming guides" seems a bit too narrow for what it contains (e.g., Local/Cluster execution). Perhaps rename to "Usage"? => I didn't address this, because we had it as programming guide before. I would also address this on the ML.

---

Can someone check it out again and then merge.

[ktzoumas]

Good to merge