Doc mainpage / README update.

Fixed so the doc is not just poorly repeating what's already said on the
homepage.

README.md

@@ -6,7 +6,11 @@ it to have all the convenience utilities around yet stay small, powerful and
 not give up on flexibility? *Here it is.* And it's free to use, even for
 commercial purposes.
 
-[![Join the chat at https://gitter.im/mosra/magnum](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/mosra/magnum?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![Build Status](https://travis-ci.org/mosra/magnum.svg?branch=master)](https://travis-ci.org/mosra/magnum) [![Build Status](https://ci.appveyor.com/api/projects/status/5b477m034cfaskse/branch/master?svg=true)](https://ci.appveyor.com/project/mosra/magnum/branch/master) [![Coverage Status](https://coveralls.io/repos/github/mosra/magnum/badge.svg?branch=master)](https://coveralls.io/github/mosra/magnum?branch=master)
+[![Join the chat at https://gitter.im/mosra/magnum](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/mosra/magnum?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[![Build Status](https://travis-ci.org/mosra/magnum.svg?branch=master)](https://travis-ci.org/mosra/magnum)
+[![Build Status](https://ci.appveyor.com/api/projects/status/5b477m034cfaskse/branch/master?svg=true)](https://ci.appveyor.com/project/mosra/magnum/branch/master)
+[![Coverage Status](https://coveralls.io/repos/github/mosra/magnum/badge.svg?branch=master)](https://coveralls.io/github/mosra/magnum?branch=master)
+[![MIT License](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 -   Project homepage — http://magnum.graphics/
 -   Documentation — http://doc.magnum.graphics/
@@ -69,10 +73,14 @@ per-platform build status.
 BUILDING MAGNUM
 ===============
 
-You can either use packaging scripts, which are stored in the `package/`
+You can either use packaging scripts, which are stored in the
-subdirectory, or compile and install everything manually. A short guide is
+[package/](https://github.com/mosra/magnum/tree/master/package) subdirectory,
-below, for complete documentation for all platforms head over to the
+or compile and install everything manually. A short guide is below, for better
-[Magnum documentation](http://doc.magnum.graphics/magnum/building.html).
+introduction it's advised to read through the
+[Getting Started Guide](http://doc.magnum.graphics/magnum/getting-started.html)
+in the documentation. Complete building documentation covering all platforms
+and feature sets is in the [Downloading and building](http://doc.magnum.graphics/magnum/building.html)
+page.
 
 Minimal dependencies
 --------------------
@@ -131,8 +139,11 @@ be in the `build/doc/` directory. Snapshot of the documentation is
 GETTING STARTED
 ===============
 
-The Doxygen documentation has a thorough [guide how to start using Magnum](http://doc.magnum.graphics/magnum/getting-started.html)
+The best way to get started is to read the thorough
-in your project.
+[download, build, install and start using Magnum](http://doc.magnum.graphics/magnum/getting-started.html)
+in your project. After that, there are various [tutorials and examples](http://doc.magnum.graphics/magnum/example-index.html)
+and a complete [feature guide](http://doc.magnum.graphics/magnum/features.html)
+explaining all aspects of the library.
 
 RELATED PROJECTS
 ================

doc/mainpage.dox

@@ -28,70 +28,18 @@ namespace Magnum {
 
 * *Lightweight and modular C++11/C++14 graphics middleware to power your dreams.*
 
-Looking for an open-source library that gives you graphics abstraction and
+This is a documentation for the Magnum Project. To see high-level feature
-platform independence on major desktop, mobile and web platforms? Do you want
+overview, project goals or read the developer blog, head over to the
-it to have all the convenience utilities around yet stay small, powerful and
+[project homepage](http://magnum.graphics/).
-not give up on flexibility? *Here it is.* And it's free to use, even for
-commercial purposes.
-
--   Project homepage --- http://magnum.graphics/
--   Documentation --- http://doc.magnum.graphics/
--   GitHub project page --- https://github.com/mosra/magnum
-
-@section mainpage-goals1 Beauty of simplicity
-
-Among Magnum essentials is a UTF-8-aware OS, filesystem and console
-abstraction, a feature-packed vector math library and a slim C++11 wrapper of
-OpenGL / WebGL family of APIs. Build on top of that or opt-in for more.
-
-[See all core features »](http://magnum.graphics/features/)
-
-@section mainpage-goals2 With batteries included
-
-Shaders and primitives for fast prototyping, algorithms, debugging and
-automatic testing, asset management, integration with popular windowing
-toolkits and a UI library. Everything fits together but you still have a
-choice.
-
-[List the extra features »](http://magnum.graphics/features/extras/)
-
-@section mainpage-goals3 Screws are not glued in
-
-There's always more than one way to do things. Enjoy the freedom of choice and
-integrate your own asset loader, texture compressor, font format or math
-library, if you feel the need. Or use any of the various plugins.
-
-[View extension points »](http://magnum.graphics/features/extensions/)
-
-* *Looking for more?* There's a [Showcase page](http://magnum.graphics/showcase/)
-right behind the corner with lots of WebGL demos.
-
-@section mainpage-platforms Supported platforms
-
--   **Linux** and embedded Linux
--   **Windows**, **Windows RT** (Store/Phone)
--   **macOS**, **iOS**
--   **Android**
--   **Web** ([asm.js](http://asmjs.org/) or [WebAssembly](http://webassembly.org/)),
-    through [Emscripten](http://kripken.github.io/emscripten-site/)
-
-Graphics APIs:
-
--   **OpenGL** 2.1 through 4.5, core profile functionality and modern
-    extensions
--   **OpenGL ES** 2.0, 3.0, 3.1 and extensions to match desktop OpenGL
-    functionality
--   **WebGL** 1.0, 2.0 and extensions to match desktop OpenGL functionality
-
-See the [Build Status page](http://magnum.graphics/build-status/) on the
-project website for detailed per-platform build status.
 
 @section mainpage-building Building Magnum
 
 You can either use packaging scripts, which are stored in the `package/`
-subdirectory, or compile and install everything manually. A short guide is
+subdirectory [of the Git repository](https://github.com/mosra/magnum/tree/master/package),
-below, for complete documentation for all platforms head over to the
+or compile and install everything manually. A short guide is below, for better
-@ref building page.
+introduction it's advised to read through the
+@ref getting-started "Getting Started Guide". Complete building documentation
+covering all platforms and feature sets is in the @ref building page.
 
 @subsection mainpage-building-dependencies Minimal dependencies
 
@@ -144,8 +92,11 @@ be in the `build/doc/` directory.
 
 @section mainpage-getting-started Getting started
 
-Read the thorough @ref getting-started "guide to download, build, install and start using Magnum"
+The best way to get started is to read the thorough
-in your project.
+@ref getting-started "guide to download, build, install and start using Magnum"
+in your project. After that, there are various @ref example-index "tutorials and examples"
+and a complete @ref features "feature guide" explaining all aspects of the
+library.
 
 @section mainpage-contact Contact & support
 
@@ -160,7 +111,7 @@ keep the library as consistent and maintainable as possible.
 -   Documentation --- http://doc.magnum.graphics/
 -   GitHub project page --- https://github.com/mosra/magnum
 -   Gitter community chat --- https://gitter.im/mosra/magnum
--   IRC --- join the <tt>#magnum-engine</tt> channel on freenode
+-   IRC --- join the <tt>\#magnum-engine</tt> channel on freenode
 -   Google Groups mailing list --- magnum-engine@googlegroups.com ([archive](https://groups.google.com/forum/#!forum/magnum-engine))
 -   Author's personal Twitter --- https://twitter.com/czmosra
 -   Author's personal e-mail --- mosra@centrum.cz