Tweaks in documentation

docs/SUMMARY.md

@@ -9,9 +9,9 @@
 
 * [Directory structure](structure.md)
 * [Pages and Summary](pages.md)
+* [Configuration](config.md)
 * [Glossary](lexicon.md)
 * [Multi-Lingual](languages.md)
-* [Configuration](config.md)
 * [AsciiDoc](asciidoc.md)
 
 ### Customization

docs/asciidoc.md

@@ -54,7 +54,7 @@ This file is used to define terms. [See the glossary section](./lexicon.md).
 Sufficiently advanced technology, beyond the understanding of the observer producing a sense of wonder.
 
 == PHP
-An atrocious language, invented for the sole purpose of inflicting pain and suffering amongst the programming wizards of this world.
+A popular web programming language, used by many large websites such as Facebook. Rasmus Lerdorf originally created PHP in 1994 to power his personal homepage (PHP originally stood for "Personal Home Page" but now stands for "PHP: Hypertext Preprocessor").
 ```
 
 

docs/languages.md

@@ -3,6 +3,8 @@
 GitBook supports building books written in multiple languages. Each language should be a sub-directory following the normal GitBook format, and a file named `LANGS.md` should be present at the root of the repository with the following format:
 
 ```markdown
+# Languages
+
 * [English](en/)
 * [French](fr/)
 * [Español](es/)

docs/plugins/README.md

@@ -19,6 +19,8 @@ Once you find a plugin that you want to install, you need to add it to your `boo
 
 You can also specify a specific version using: `"myPlugin@0.3.1"`. By default GitBook will resolve the latest version of the plugin compatbile with the current GitBook version.
 
+### GitBook.com
+
 Plugins are automatically installed on [GitBook.com](https://www.gitbook.com). Locally, run `gitbook install` to install and prepare all plugins for your books.
 
 ### Configuring plugins

docs/structure.md

@@ -1,6 +1,6 @@
 # Directory structure
 
-GitBook uses a very simple and obvious directory sttructure:
+GitBook uses a very simple and obvious directory structure:
 
 ```
 .