README.md in nanoc3-3.1.0a1 vs README.md in nanoc3-3.1.0a2

@@ -1,57 +1,53 @@
 # nanoc 3
 
 nanoc is a simple but very flexible static site generator written in Ruby.
 It operates on local files, and therefore does not run on the server. nanoc
-"compiles" the local source files into HTML (usually), by evaluating eRuby,
+“compiles” the local source files into HTML (usually), by evaluating eRuby,
 Markdown, etc.
 
-## Documentation
+## Resources
 
-The [nanoc3 web site](http://nanoc.stoneship.org) contains a few useful
+The [nanoc web site](http://nanoc.stoneship.org) contains a few useful
 resources to help you get started with nanoc:
 
 * The [tutorial](http://nanoc.stoneship.org/tutorial)
 * The [manual](http://nanoc.stoneship.org/manual)
 * The [migration guide](http://nanoc.stoneship.org/migrating)
 
-It is probably also worth checking out and perhaps subscribing to the
-discussion groups:
+If you need assistance, the following places will help you out:
 
-* The [discussion group in English](http://groups.google.com/group/nanoc)
-* The [discussion group in Spanish](http://groups.google.com/group/nanoc-es)
+* The [discussion group](http://groups.google.com/group/nanoc)
+* The [IRC channel](irc://chat.freenode.net/#nanoc)
 
-### Source Code Documentation
+## Source Code Documentation
 
-The source code is structured in a few directories:
+The source code is located in `lib/nanoc3` and is structured in a few
+directories:
 
-* `bin` contains the commandline tool aptly named `nanoc3`
-* `lib`
-  * `nanoc3`
-    * `base` contains the bare essentials necessary for nanoc to function
-    * `cli` contains the commandline interface
-    * `data_sources` contains the standard data sources (Nanoc3::DataSource
-      subclasses), such as the filesystem data source
-    * `helpers` contains helpers, which provide functionality some sites
-      may find useful, such as the blogging and tagging helpers
-    * `extra` contains stuff that is not needed by nanoc itself, but which may
-      be used by helpers, data sources, filters or VCSes.
-    * `filters` contains the standard filters (Nanoc3::Filter subclasses) such
-      as ERB, Markdown, Haml, ...
-* `test` contains testing code, structured in the same way as lib/nanoc
+* `base` contains the bare essentials necessary for nanoc to function
+* `cli` contains the commandline interface
+* `data_sources` contains the standard data sources ({Nanoc3::DataSource}
+  subclasses), such as the filesystem data source
+* `helpers` contains helpers, which provide functionality some sites
+  may find useful, such as the blogging and tagging helpers
+* `extra` contains stuff that is not needed by nanoc itself, but which may
+  be used by helpers, data sources, filters or VCSes.
+* `filters` contains the standard filters ({Nanoc3::Filter} subclasses)
+  such as ERB, Markdown, Haml, ...
 
 The namespaces (modules) are organised like this:
 
-* `Nanoc3` is the namespace for everything nanoc-related (obviously). The
+* {Nanoc3} is the namespace for everything nanoc-related (obviously). The
   classes in `lib/nanoc3/base` are part of this module (not `Nanoc3::Base`)
-  * `CLI` containing everything related to the commandline tool.
-  * `DataSources` contains the data sources
-  * `Helpers` contains the helpers
-  * `Extra` contains useful stuff not needed by nanoc itself
-  * `Filters` contains the (textual) filters
+* {Nanoc3::CLI} containing everything related to the commandline tool.
+* {Nanoc3::DataSources} contains the data sources
+* {Nanoc3::Helpers} contains the helpers
+* {Nanoc3::Extra} contains useful stuff not needed by nanoc itself
+* {Nanoc3::Filters} contains the (textual) filters
 
-The central class in nanoc is `Nanoc3::Site`, so you should start there if
+The central class in nanoc is {Nanoc3::Site}, so you should start there if
 you want to explore nanoc from a technical perspective.
 
 ## Dependencies
 
 nanoc itself can be used without installing any dependencies. Some
@@ -72,10 +68,10 @@
 * Chris Eppstein
 * Starr Horne
 * Nicky Peeters
 * Christian Plessl
 * Šime Ramov
-* "Soryu"
+* “Soryu”
 * Eric Sunshine
 * Dennis Sutch
 
 Special thanks to Ale Muñoz.