From e28de619a81eddde8c9b9f0ce6aa696f71b3357e Mon Sep 17 00:00:00 2001
From: Chris <christopher.fremond@gmail.com>
Date: Thu, 13 Jan 2022 23:04:15 +0000
Subject: [PATCH] added intro

---
 docs/db/sql.md | 31 ++++++++++++++++++++++++++++---
 1 file changed, 28 insertions(+), 3 deletions(-)

diff --git a/docs/db/sql.md b/docs/db/sql.md
index 1c325cc0..c363e082 100644
--- a/docs/db/sql.md
+++ b/docs/db/sql.md
@@ -1,6 +1,31 @@
-## Example of SQL queries
+## Introduction
 
-### sign up
+This documentation is a quickstart guide for the use of metabase in a school server.
+
+Pre-requisites:
+
+- An access account given by your administrator.
+- A basic knowledge of SQL
+
+### Where to enter your SQL queries
+
+The path to metabase is {DOMAIN}/metabase
+
+After loggin with valid credentials this is where you land,
+In the bottom section `OUR DATA`
+
+- Click on the `metabase` database.
+
+- A folder `public` should appear among others. Click on it.
+
+At this point you can see all tables of the public sql database
+To execute a query, simply click on the top right button `write SQL`
+
+Following are examples of SQL queries to help you get you started.
+
+## Examples of SQL queries
+
+### Sign up
 
 The following query returns the users that are currently in the sign up process.
 
@@ -106,7 +131,7 @@ The following query returns the amount of xp per user and per activity.
 
 ```sql
 WITH xp_user AS (
-    SELECT 
+    SELECT
         u."githubLogin",
         xp.amount,
         xp.path,