diff --git a/README.md b/README.md
--- a/README.md
+++ b/README.md
@@ -17,7 +17,7 @@
 
 CRUD operations on a given DocType are:
 
--   `GET` list of all documents (`getDocTypeList`)
+-   `GET` list of all documents of a DocType (`getDocTypeList`)
 -   `POST` to create a new document (`postDocType`)
 -   `GET` a document by name (`getDocType`)
 -   `PUT` to update a document by name (`putDocType`)
@@ -35,6 +35,9 @@
 
 ## Usage
 
+This sample code makes a GET request for a named document of the given
+DocType.
+
 ``` haskell
 {-# LANGUAGE OverloadedStrings #-}
 
@@ -49,7 +52,6 @@
 
 instance FromJSON Customer
 instance ToJSON Customer
-
 instance IsDocType Customer where
   docTypeName = "Customer"
 
@@ -105,7 +107,7 @@
 used.****
 
 ``` example
-$ ./scripts/gen-openapi-yaml.sh erpnext/models > openapi.yaml
+$ ./scripts/gen-openapi-yaml.sh models > openapi.yaml
 $ openapi3-code-generator-exe \
     --specification openapi.yaml \
     --package-name erpnext-api-client-models \
diff --git a/erpnext-api-client.cabal b/erpnext-api-client.cabal
--- a/erpnext-api-client.cabal
+++ b/erpnext-api-client.cabal
@@ -1,9 +1,10 @@
 cabal-version:       3.6
 
 name:                erpnext-api-client
-version:             0.0.0.1
-description:         xxx
-homepage:            xxx
+version:             0.1.0.0
+synopsis:            Generic API client library for ERPNext
+description:         This is a Haskell API client for ERPNext. It aims to be a light-weight library based on http-client and user-provided record types.
+homepage:            https://github.com/schoettl/erpnext-api-client
 license:             MIT
 license-file:        LICENSE
 author:              Jakob Schöttl