docs(api): describe use of lower-level methodsdocs/lower-level-api

1 files changed, 8 insertions, 0 deletions

diff --git a/README.rst b/README.rst
index 838943c..52dbfc4 100644
--- a/README.rst
+++ b/README.rst
@@ -26,6 +26,14 @@ python-gitlab
 
 It supports the v4 API of GitLab, and provides a CLI tool (``gitlab``).
 
+The client aims to let you write clean Python code when managing GitLab resources.
+You can pass arbitrary parameters to the GitLab API - so you only need to
+follow GitLab's current documentation on what parameters are available.
+
+It also provides lower-level API methods giving you a degree of control and
+usability for any endpoint the moment it is available on GitLab.com or your
+GitLab instance.
+
 Installation
 ------------