diff --git a/docs/tutorials/getting-started.ipynb b/docs/tutorials/getting-started.ipynb
new file mode 100644
index 0000000..8f61f7f
--- /dev/null
+++ b/docs/tutorials/getting-started.ipynb
@@ -0,0 +1,309 @@
+{
+ "cells": [
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "---\n",
+ "title: Getting started\n",
+ "description: A typical workflow with the package, creating a single table\n",
+ "---"
+ ]
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "In this tutorial, we go over the typical sort of interaction a user will have\n",
+ "with the package: retrieving a table from the API.\n",
+ "\n",
+ "## Making a connection\n",
+ "\n",
+ "We begin by importing the `CensusAPI` class from the package and creating an\n",
+ "instance of it. This class is how we connect to the custom table creator API."
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 1,
+ "metadata": {},
+ "outputs": [],
+ "source": [
+ "from census21api import CensusAPI\n",
+ "\n",
+ "api = CensusAPI()"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": null,
+ "metadata": {},
+ "outputs": [],
+ "source": []
+ },
+ {
+ "cell_type": "markdown",
+ "metadata": {},
+ "source": [
+ "## Defining a query\n",
+ "\n",
+ "Now, to query a table, we need three parameters:\n",
+ "\n",
+ "- a population type (e.g. household reference persons, usual residents)\n",
+ "- an area type (e.g. local authorities, Senedd electoral regions)\n",
+ "- some dimensions (e.g. english proficiency, economic activity)\n",
+ "\n",
+ "Let's say we are interested in the relationship between binary sex and health\n",
+ "across the regions of England and Wales. Then our parameters are:\n",
+ "\n",
+ "- population type: usual residents in the UK\n",
+ "- area type: region\n",
+ "- dimensions: sex and health in general\n",
+ "\n",
+ "\n",
+ "## Retrieving a table\n",
+ "\n",
+ "With that information, we can use our `CensusAPI` instance to retrieve the\n",
+ "corresponding table from the API using its `query_table()` method:"
+ ]
+ },
+ {
+ "cell_type": "code",
+ "execution_count": 2,
+ "metadata": {},
+ "outputs": [
+ {
+ "data": {
+ "text/html": [
+ "\n",
+ "\n",
+ "
\n",
+ " \n",
+ " \n",
+ " | \n",
+ " rgn | \n",
+ " sex | \n",
+ " health_in_general | \n",
+ " count | \n",
+ " population_type | \n",
+ "
\n",
+ " \n",
+ " \n",
+ " \n",
+ " | 0 | \n",
+ " North East | \n",
+ " Female | \n",
+ " Does not apply | \n",
+ " 0 | \n",
+ " UR | \n",
+ "
\n",
+ " \n",
+ " | 1 | \n",
+ " North East | \n",
+ " Female | \n",
+ " Very good health | \n",
+ " 589597 | \n",
+ " UR | \n",
+ "
\n",
+ " \n",
+ " | 2 | \n",
+ " North East | \n",
+ " Female | \n",
+ " Good health | \n",
+ " 454204 | \n",
+ " UR | \n",
+ "
\n",
+ " \n",
+ " | 3 | \n",
+ " North East | \n",
+ " Female | \n",
+ " Fair health | \n",
+ " 209830 | \n",
+ " UR | \n",
+ "
\n",
+ " \n",
+ " | 4 | \n",
+ " North East | \n",
+ " Female | \n",
+ " Bad health | \n",
+ " 77783 | \n",
+ " UR | \n",
+ "
\n",
+ " \n",
+ " | ... | \n",
+ " ... | \n",
+ " ... | \n",
+ " ... | \n",
+ " ... | \n",
+ " ... | \n",
+ "
\n",
+ " \n",
+ " | 115 | \n",
+ " Wales | \n",
+ " Male | \n",
+ " Very good health | \n",
+ " 722822 | \n",
+ " UR | \n",
+ "
\n",
+ " \n",
+ " | 116 | \n",
+ " Wales | \n",
+ " Male | \n",
+ " Good health | \n",
+ " 490429 | \n",
+ " UR | \n",
+ "
\n",
+ " \n",
+ " | 117 | \n",
+ " Wales | \n",
+ " Male | \n",
+ " Fair health | \n",
+ " 210031 | \n",
+ " UR | \n",
+ "
\n",
+ " \n",
+ " | 118 | \n",
+ " Wales | \n",
+ " Male | \n",
+ " Bad health | \n",
+ " 73638 | \n",
+ " UR | \n",
+ "
\n",
+ " \n",
+ " | 119 | \n",
+ " Wales | \n",
+ " Male | \n",
+ " Very bad health | \n",
+ " 24084 | \n",
+ " UR | \n",
+ "
\n",
+ " \n",
+ "
\n",
+ "
120 rows × 5 columns
\n",
+ "
diff --git a/docs/tutorials/installation.qmd b/docs/tutorials/installation.qmd
new file mode 100644
index 0000000..787822d
--- /dev/null
+++ b/docs/tutorials/installation.qmd
@@ -0,0 +1,40 @@
+---
+title: Installing the package
+description: >
+ Instructions for the various ways you can install the `census21api` package
+---
+
+Currently, the `census21api` package is only installable through GitHub. We
+also require Python 3.8 or higher.
+
+## Installing from GitHub via `pip`
+
+To install from GitHub via `pip`, use the following command:
+
+```bash
+$ python -m pip install census21api@git+https://github.com/datasciencecampus/census21api
+```
+
+## Installing from source
+
+If you would prefer to install directly from source, use the following
+commands:
+
+```bash
+$ git clone https://github.com/datasciencecampus/census21api.git
+$ cd census21api
+$ python -m pip install .
+```
+
+## Installing to contribute
+
+If you intend on doing any sort of development on `census21api` - like writing documentation or implementing a new feature - it is highly recommended to
+install from source _as editable_ and _with the development dependencies_.
+
+To do so, make a fork of the repository and then run the following:
+
+```bash
+$ git clone https://github.com//census21api.git
+$ cd census21api
+$ python -m pip install -e ".[dev]"
+```