2 files changed, 37 insertions, 25 deletions

diff --git a/README.md b/README.md
index d685bb5f..57544a4c 100644
--- a/README.md
+++ b/README.md
@@ -1,27 +1,24 @@
-# Synopsis
+### Synopsis
 
-This package aims to provide a thin layer for bittorrent protocol.
-Basically it provides serialization\deserealization and some widely
-used routines.
+A library for making Haskell applications which use bittorrent
+protocol easy. This package aims to be a fast thin layer and at the
+same time provide both:
 
-# Description
+* Concise high level API for typical usage scenarious.
+* More straightforward API if you need more fine grained control.
 
-## Modules
+Currently it provides serialization and deserealization of core
+datatypes, some widely used routines and core types.
 
-The module hierarhy is tend to be:
 
-* Data.Torrent — for torrent metainfo, data verification, etc
-* Network.BitTorrent.Peer     — common peer related types.
-* Network.BitTorrent.PeerWire — peer wire TCP message passing.
-* Network.BitTorrent.Tracker  — tracker HTTP message passing.
+### Status
 
-# Status
-
-The protocol has many extensions[1] and it's seems like no one want to
-use just core protocol, at least I'm not. Any modern application that
-uses bittorrent protocol in any way will use some subset of extensions
-anyway. Thus it's reasonable to implement at least some part of widely
-used extensions here, so we could provide nice high level API and well
+The protocol has many extensions(more precisely enchancements, but
+we'll use that word) and it's seems like no one will want to use just
+core protocol, at least I'm not. Any modern application that uses
+bittorrent protocol in any way will use some subset of extensions.
+Thus it's reasonable to implement at least some part of widely used
+extensions here, so we could provide nice high level API and well
 integrated interface.
 
 This section should keep track current state of package in respect of
@@ -62,14 +59,25 @@ too)
 | 5     | DHT                                        |                                     | Want
 | 6     | Fast Extension                             | Network.BitTorrent.PeerWire.Message | Want -> Implemented
 
-# Build Status
+
+### Documentation
+
+For documentation see haddock generated documentation.
+
+
+### Build Status
 
 [![Build Status][1]][2]
 
-[1]: https://travis-ci.org/pxqr/network-bittorrent.png
-[2]: https://travis-ci.org/pxqr/network-bittorrent
+[1]: https://travis-ci.org/pxqr/bittorrent.png
+[2]: https://travis-ci.org/pxqr/bittorrent
+
+
+### Maintainer
 
+This library is written and maintained by Sam T. <pxqr.sta@gmail.com>
 
-### Footnotes
+Feel free to report bugs and suggestions via
+[github issue tracker][issues] or the mail.
 
-[1] More precisely enchancements, but we'll use that word.
+[issues]:      https://github.com/pxqr/bittorrent/issues/new
diff --git a/bittorrent.cabal b/bittorrent.cabal
index 117758f0..d911c71f 100644
--- a/bittorrent.cabal
+++ b/bittorrent.cabal
@@ -13,11 +13,15 @@ bug-reports:           https://github.com/pxqr/bittorrent/issues
 synopsis:              Bittorrent protocol implementation.
 description:
 
-  Straightforward and incomplete implementation of bittorrent protocol.
+  A library for making applications which use bittorrent protocol in Haskell easy.
+  .
+  See <https://github.com/pxqr/bittorrent/blob/master/README.md> for more information.
+
+
 
 source-repository head
   type:                git
-  location:            https://github.com/pxqr/bittorrent.git
+  location:            git://github.com/pxqr/bittorrent.git
 
 
 library