Update README

Reword most parts of the README file, add information on new features
and update the directory layout.

Signed-off-by: Lukas Fleischer <lfleischer@archlinux.org>

1 files changed, 25 insertions, 23 deletions

diff --git a/README b/README
index 19881864..5ab84ab4 100644
--- a/README
+++ b/README
@@ -1,40 +1,42 @@
 aurweb
 ======
 
-aurweb is a framework for hosting the Arch User Repository (AUR), a collection
+aurweb is a hosting platform for the Arch User Repository (AUR), a collection
 of packaging scripts that are created and submitted by the Arch Linux
-community. The scripts contained in the repository (PKGBUILDs) can be built
-using makepkg and installed via the Arch Linux package manager pacman. The
-aurweb project aims to provide the necessary web interface, database schema,
-and scripts for a multi-lingual community-driven repository.
-
-Functionality
--------------
-
-* Users may submit source packages that contain a PKGBUILD.
-* User accounts with varying permission levels (User, Trusted User, Developer).
-* Ability to search for specific submitted packages.
-* Display package information by parsing meta-data provided with the packages.
-* Users can make comments on package information page.
-* Mark packages as out-of-date.
-* Vote for well-done and popular user submitted packages.
-* Trusted User and Developer can search for and modify accounts.
+community. The scripts contained in the repository can be built using `makepkg`
+and installed using the Arch Linux package manager `pacman`.
+
+The aurweb project includes
+
+* A web interface to search for packaging scripts and display package details.
+* A SSH/Git interface to submit and update packages and package meta data.
+* Community features such as comments, votes, package flagging and requests.
+* Editing/deletion of packages and accounts by Trusted Users and Developers.
 * Area for Trusted Users to post AUR-related proposals and vote on them.
 
 Directory Layout
 ----------------
 
+conf::
+	Configuration and configuration templates.
+
 doc::
-	aurweb documentation.
+	Project documentation.
+
+git-interface::
+	Scripts that make up the Git and SSH interface.
 
 po::
 	Translation files for strings in the aurweb interface.
 
+schema::
+	Schema for the SQL database. Script for dummy data generation.
+
 scripts::
-	aurblup package blacklist tool. Scripts for AUR maintenance.
+	Scripts for AUR maintenance.
 
-support::
-	Schema for SQL database. Script for dummy data generation.
+upgrading::
+	Instructions for upgrading setups from one release to another.
 
 web::
 	Web interface for the AUR.
@@ -43,9 +45,9 @@ Links
 -----
 
 * The repository is hosted at git://git.archlinux.org/aurweb.git -- see
-  doc/CodingGuidelines for information on submitting patches.
+  doc/CodingGuidelines for information on the patch submission process.
 
-* Discovered bugs can be submitted to the aurweb bug tracker:
+* Bugs can (and should) be submitted to the aurweb bug tracker:
   https://bugs.archlinux.org/index.php?project=2
 
 * Questions, comments, and patches related to aurweb can be sent to the AUR