diff --git a/KorAPClient/__init__.py b/KorAPClient/__init__.py
index 9571401..d329bfb 100644
--- a/KorAPClient/__init__.py
+++ b/KorAPClient/__init__.py
@@ -1,36 +1,161 @@
+__pdoc__ = { 'tests': False }
 import rpy2.robjects.packages as packages
 import rpy2.robjects.pandas2ri as pandas2ri
 from rpy2.robjects.methods import RS4
+from pandas import DataFrame
 
 KorAPClient = packages.importr('RKorAPClient')
 pandas2ri.activate()
 
-
+# noinspection PyPep8Naming
 class KorAPConnection(RS4):
+    """Connection to a KorAP server."""
+
     def __init__(self, *args, **kwargs):
+        """Constructor keyword arguments:
+
+        - **KorAPUrl** (default = `"https://korap.ids-mannheim.de/"`)
+        - **apiVersion** (default = 'v1.0')
+        - **apiUrl**
+        - **accessToken** (default = `getAccessToken(KorAPUrl)`
+        - **userAgent** (default = `"Python-KorAP-Client"`)
+        - **timeout** (default = 110)
+        - **verbose** (default = False)
+        - **cache** (dafault = True)
+        """
+        if 'userAgent' not in kwargs:
+            kwargs["userAgent"] = "Python-KorAP-Client"
         kco = KorAPClient.KorAPConnection(*args, **kwargs)
         super().__init__(kco)
 
     def corpusStats(self, *args, **kwargs):
+        """Query the size of the whole corpus or a virtual corpus specified by the vc argument.
+
+            - vc = ""
+            - verbose = kco@verbose
+            - as.df = False
+
+        Returns:
+            `DataFrame`|`RS4`
+
+        Example:
+            ```
+            $ df = kcon.corpusStats("pubDate in 2018 & textType=/Zeit.*/ & pubPlaceKey=IT", **{"as.df": True})
+            $ df["tokens"]
+            12150897
+            ```
+        """
         return KorAPClient.corpusStats(self, *args, **kwargs)
 
     def frequencyQuery(self, *args, **kwargs):
+        """Query relative frequency of search term(s).
+
+        - **query** – query string or list of query strings
+        - **vc** - virtual corpus definition or list thereof  (default: "")
+        - **conf.level** – confidence level of the returned confidence interval (default = 0.95)
+        - **as.alternatives** – decides whether queries should be treated as mutually exclusive and exhaustive wrt. to some meaningful class (e.g. spelling variants of a certain word form) (default = False)
+        - **KorAPUrl** – instead of specifying the `query` and `vc` string parameters, you can copy your KorAP query URL here from the browser
+        - **metadataOnly** – determines whether queries should return only metadata without any snippets. This can also be useful to prevent access rewrites. (default = True)
+        - **ql** – query language: `"poliqarp" | "cosmas2" | "annis" | "cql" | "fcsql"` (default = `"poliqarp"`)
+        - **accessRewriteFatal** – abort if query or given vc had to be rewritten due to insufficient rights (not yet implemented) (default = `True`)
+        - **verbose** – (default = `self.verbose`)
+        - **expand** – bool that decides if `query` and `vc` parameters are expanded to all of their combinations (default = `len(vc) != len(query)`)
+
+        Returns:
+            DataFrame with columns `'query', 'totalResults', 'vc', 'webUIRequestUrl', 'total', 'f',
+           'conf.low', 'conf.high'`.
+
+        Example:
+            ```
+            $ kcon = KorAPConnection(verbose=True)
+            $ kcon.frequencyQuery("Ameisenplage", vc=["pubDate in "+str(y) for y in range(2010,2015)])
+                                  query  totalResults  ...      conf.low     conf.high
+            1  Ameisenplage             3  ...  9.727696e-10  1.200289e-08
+            2  Ameisenplage            12  ...  3.838218e-09  1.275717e-08
+            3  Ameisenplage             5  ...  2.013352e-09  1.356500e-08
+            4  Ameisenplage             6  ...  2.691331e-09  1.519888e-08
+            5  Ameisenplage             3  ...  8.629463e-10  1.064780e-08
+            ```
+        """
         return KorAPClient.frequencyQuery(self, *args, **kwargs)
 
     def corpusQuery(self, *args, **kwargs):
+        """Query search term(s).
+
+        - **query** – query string or list of query strings
+        - **vc** - virtual corpus definition or list thereof (default: "")
+        - **KorAPUrl** – instead of specifying the `query` and `vc` string parameters, you can copy your KorAP query URL here from the browser
+        - **metadataOnly** – determines whether queries should return only metadata without any snippets. This can also be useful to prevent access rewrites. (default = True)
+        - **ql** – query language: `"poliqarp" | "cosmas2" | "annis" | "cql" | "fcsql"` (default = `"poliqarp"`)
+        - **fields** – (meta)data fields that will be fetched for every match (default = `["corpusSigle", "textSigle", "pubDate",  "pubPlace", "availability", "textClass"]`)
+        - **verbose** – (default = `self.verbose`)
+
+        Returns:
+            `KorAPQuery` | `pandas.DataFrame`
+
+        Example:
+            ```
+            $ kcon = KorAPConnection(verbose=True)
+            $ q = kcon.corpusQuery("Ameisenplage")
+            $ q = q.fetchAll()
+            $ q.slots['collectedMatches']
+                corpusSigle  ...                                          textClass
+            1         WPD17  ...                                                NaN
+            2         WPD17  ...                                                NaN
+            3         WPD17  ...                                                NaN
+            4         WPD17  ...                                                NaN
+            5         WPD17  ...                                                NaN
+            ..          ...  ...                                                ...
+            126         Z83  ...                       freizeit-unterhaltung reisen
+            127       MZE03  ...  freizeit-unterhaltung reisen natur-umwelt wett...
+            128       MZE03  ...  freizeit-unterhaltung reisen staat-gesellschaf...
+            129       MZE14  ...  wissenschaft populaerwissenschaft freizeit-unt...
+            130       MZE00  ...                  wissenschaft populaerwissenschaft
+            [130 rows x 6 columns]
+            ```
+        """
         return KorAPQuery(self, *args, **kwargs)
 
 
 class KorAPQuery(RS4):
+    """Query to a KorAP server."""
+
+
     def __init__(self, *args, **kwargs):
         kco = KorAPClient.corpusQuery(*args, **kwargs)
         super().__init__(kco)
 
     def fetchNext(self, *args, **kwargs):
+        """Fetch next couple of query results
+
+        - **offset** – start offset for query results to fetch
+        - **maxFetch** – maximum number of query results to fetch
+        - **verbose**
+
+        Returns:
+            `KorAPQuery`
+        """
         return KorAPClient.fetchNext(self, *args, **kwargs)
 
     def fetchRest(self, *args, **kwargs):
+        """Fetch remaining query results
+
+        - **verbose**
+
+        Returns:
+            `KorAPQuery`
+        """
         return KorAPClient.fetchRest(self, *args, **kwargs)
 
     def fetchAll(self, *args, **kwargs):
+        """Fetch all query results
+
+        - **verbose**
+
+        Returns:
+            `KorAPQuery`
+
+        Example:
+            See `KorAPConnection.corpusQuery`.
+        """
         return KorAPClient.fetchAll(self, *args, **kwargs)
diff --git a/KorAPClient/tests/__init__.py b/KorAPClient/tests/__init__.py
index e69de29..8b13789 100644
--- a/KorAPClient/tests/__init__.py
+++ b/KorAPClient/tests/__init__.py
@@ -0,0 +1 @@
+
diff --git a/Readme.md b/Readme.md
index 40613ed..c0f7ae0 100644
--- a/Readme.md
+++ b/Readme.md
@@ -40,8 +40,9 @@
 python3 -m pip install git+https://github.com/KorAP/PythonKorAPClient
 ```
 ## Documentation
-Currently, there is no dedicated documentation for the Python variant of the library. Please refer to the [Refernce Manual of RKorAPClient](https://cran.r-project.org/web/packages/RKorAPClient/RKorAPClient.pdf) for now. 
-For translating the R syntax to Python and vice versa, pleas refer to the [rpy2 Documentation](https://rpy2.github.io/doc/latest/html/index.html).
+The core classes and methods to access the KorAP AP are documented in the [KorAPClient API documentation](https://korap.github.io/PythonKorAPClient/html/KorAPClient/).
+For additional, mostly static helper functions, please refer to the [Refernce Manual of RKorAPClient](https://cran.r-project.org/web/packages/RKorAPClient/RKorAPClient.pdf) for now. 
+For translating R syntax to Python and vice versa, refer to the [rpy2 Documentation](https://rpy2.github.io/doc/latest/html/index.html).
 
 Please note that some arguments in the original RKorAPClient functions use characters that are not allowed in Python keyword argument names.
 For these cases, you can however use Python's `**kwargs` syntax.
@@ -49,7 +50,7 @@
 ```python
 from KorAPClient import KorAPConnection
 kcon = KorAPConnection(verbose=True)
-print(kcon.corpusStats(**{"as.df": True})['tokens'])
+print(kcon.corpusStats(**{"as.df": True})['tokens'][0])
 ```
 
 ## Examples