Improve descriptions

doc/README.md

@@ -1,29 +1,37 @@
 # Documentation Index
 
-The following is a list of documentation files and a brief description to aid
+The following is a list of documentation files and a brief description, if
-in locating documentation (sorted alphabetically).
+    applicable, to aid in locating documentation (sorted alphabetically
+    per-section).
 
 ## Lua
 
-- [Builtin Entities](builtin_entities.md): Documentation of core engine entities.
+- [Builtin Entities](builtin_entities.md): Internal predefined engine entities.
-- [Client-side API](client_lua_api.md): Documentation on client side lua API
+- [Client-side API](client_lua_api.md): Client side enviorment's Lua API.
-    enviorment.
+- [Formspec Toolkit API](fst_api.txt)
-- [Formspec Toolkit API](fst_api.txt): Documentation on formspec toolkit.
+- [Menu API](menu_lua_api.md): Lua API for the creation of engine menus, not the
-- [Menu API](menu_lua_api.md): Documentation lua API for menu enviorment.
+    mod API.
-- [Mod API](lua_api.md): Documentation on lua API for mod enviorment.
+- [Mod APIs](lua_api.md): Lua APIs avalible within the mod enviorment and mapgen
+    enviorment. Contains infromation related to texturing and structure of games,
+    mods, and texture packs. **Related**: [Texture Packs](texture_packs.md) and
+    [World Format](world_format.md).
 
 ## Formats and Content
 
-- [Texture Packs](texture_packs.md): Documentation on Luanti's texture packs system.
+- [Texture Packs](texture_packs.md): Layout and description of Luanti's texture
-- [World Format](world_format.md): Documentation on Luanti world format.
+    packs structure and configuration. Related information can be found in the
+    [mod API](lua_api.md).
+- [World Format](world_format.md): Layout and description of Luanti's world
+    format. Documents the structure of the dirrectories and the files therein,
+    including the structure of the internal world related databases.
 
 ## Protocals
 
-- [Protocol](protocol.txt): Documentation on Luanti's network protocol.
+- [Protocol](protocol.txt): *Rough* outline of Luanti's network protocol.
 
 ## Misc.
 
-- [Android information](android.md): Documentation relating to Luanti on the Android platform.
+- [Android Information](android.md)
-- [Docker Server](docker_server.md): Documentation on Luanti's Docker server.
+- [Docker Server](docker_server.md)
-- [Luanti Development Direction](direction.md): Official Luanti development direction information.
+- [Luanti Development Direction](direction.md)
-- [Major Breakages List](breakages.md): Documentation of breaking changes.
+- [List of Major Breakages](breakages.md)