From f27878cbaa6139926c07013ad29cb6158d7fc6a4 Mon Sep 17 00:00:00 2001
From: Michael Pohl <mpohl@tidal.com>
Date: Fri, 1 Nov 2024 14:36:26 +0100
Subject: [PATCH] Add basic readme.

---
 tidalapi/README.md | 20 +++++++++-----------
 1 file changed, 9 insertions(+), 11 deletions(-)

diff --git a/tidalapi/README.md b/tidalapi/README.md
index 3389f598..b9eaa7ea 100644
--- a/tidalapi/README.md
+++ b/tidalapi/README.md
@@ -1,17 +1,15 @@
 # Module tidalapi
 
-This module provides easy access to the TIDAL Open API.
+This module provides easy access to the TIDAL Open API. Read more about it [here](https://developer.tidal.com/apiref?spec=catalogue-v2&ref=get-albums-v2&at=THIRD_PARTY).
 
----
 ## Prerequisites
 
-tbd
----
-## Installation
+To effectively use this module, you will need to be able to provide a `CredentialsProvider` instance
+from the `auth` module. This is necessary to authenticate with the TIDAL API.
 
-tbd
----
-<!-- USAGE EXAMPLES -->
-## Usage
-
-tbd
+Instantiate your `TidalApiClient` like this:
+```kotlin
+val client = TidalApiClient(credentialsProvider)
+```
+This client exposes the various API endpoints available as `Retrofit` service instances. You can
+then call the methods on these services to interact with the TIDAL API.