diff --git a/README.md b/README.md
index 75a82f385..164ba4cf3 100644
--- a/README.md
+++ b/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.
-[](https://gitter.im/mosra/magnum?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [](https://travis-ci.org/mosra/magnum) [](https://ci.appveyor.com/project/mosra/magnum/branch/master) [](https://coveralls.io/github/mosra/magnum?branch=master)
+[](https://gitter.im/mosra/magnum?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
+[](https://travis-ci.org/mosra/magnum)
+[](https://ci.appveyor.com/project/mosra/magnum/branch/master)
+[](https://coveralls.io/github/mosra/magnum?branch=master)
+[](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/`
-subdirectory, or compile and install everything manually. A short guide is
-below, for complete documentation for all platforms head over to the
-[Magnum documentation](http://doc.magnum.graphics/magnum/building.html).
+You can either use packaging scripts, which are stored in the
+[package/](https://github.com/mosra/magnum/tree/master/package) subdirectory,
+or compile and install everything manually. A short guide is below, for better
+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)
-in your project.
+The best way to get started is to read the thorough
+[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
================
diff --git a/doc/mainpage.dox b/doc/mainpage.dox
index 53fdd632c..20946a36b 100644
--- a/doc/mainpage.dox
+++ b/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
-platform independence on major desktop, mobile and web platforms? Do you want
-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.
-
-- 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.
+This is a documentation for the Magnum Project. To see high-level feature
+overview, project goals or read the developer blog, head over to the
+[project homepage](http://magnum.graphics/).
@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
-below, for complete documentation for all platforms head over to the
-@ref building page.
+subdirectory [of the Git repository](https://github.com/mosra/magnum/tree/master/package),
+or compile and install everything manually. A short guide is below, for better
+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"
-in your project.
+The best way to get started is to read the thorough
+@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 #magnum-engine channel on freenode
+- IRC --- join the \#magnum-engine 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