Beautify docs a little bit.

Signed-off-by: Julian Wollrath <jwollrath@web.de>

docs/01-readme.md

@@ -1,4 +1,6 @@
-# awesome
+# Readme
+
+## About awesome
 
 awesome is a highly configurable, next generation framework window manager for X.
 

docs/config.ld.in

@@ -13,6 +13,8 @@ pretty='lua'
 style="!pale"
 backtick_references=true
 merge=true
+use_markdown_titles = true
+wrap=true
 topics={
     '00-authors.md',
     '01-readme.md',
@@ -25,6 +27,12 @@ tparam_alias('tag', 'tag')
 -- Should be default, but is not.  Sets up "@tab" => "@tparam table".
 tparam_alias('tab', 'table')
 
+-- More fitting section names
+kind_names={topic='Documentation',module='Libraries'}
+
+-- Sort modules alphabetically
+sort_modules=true
+
 file = {
     -- LUA libraries
     'capi/',