Improve tutorials

Author: Ndpnt

content/collections/tutorials/create-collection.md

@@ -7,14 +7,86 @@ weight: 1
 
 This tutorial will guide you through creating your first Open Terms Archive collection.
 
-By the end, you'll have a working collection that tracks changes to a service's privacy policy. You will also have a basic understanding of how to create a collection and how to set up the API.
+By the end, you'll have a working collection that tracks changes to a service's privacy policy. You will also have a basic understanding of how to create a collection.
 
 ## Prerequisites
 
 - Node.js installed on your system
 - Basic familiarity with the command line
 - A text editor
 
-## Track a terms
+## Create a collection
 
 ### Step 1: Set up the project structure
+
+1. Create a new directory:
+    ```bash
+    mkdir ota-tutorial-declarations
+    cd ota-tutorial-declarations
+    ```
+
+2. Create a `declarations` directory inside the project. This is where you will declare the service and terms you want to track:
+    ```bash
+    mkdir declarations
+    ```
+
+3. Create the configuration file for the collection:
+    ```bash
+    mkdir config
+    ```
+
+### Step 2: Create the service declaration
+
+4. Create a file `declarations/Open Terms Archive.js` with the basic structure, the first thing to declare is the service name:
+    ```json
+    {
+      "name": "Open Terms Archive",
+      "documents": {
+        "Privacy Policy": {
+          "fetch": "https://opentermsarchive.org/en/privacy-policy",
+          "select": ".textcontent"
+        }
+      }
+    }
+    ```
+
+### Step 2: Create the metadata file
+
+6. Create a file `metadata.yaml`:
+    ```yaml
+    id: ota-tutorial
+    name: Tutorial collection
+    tagline: Learn how to create an Open Terms Archive collection
+    description: |
+      A step-by-step tutorial collection that guides through creating an Open Terms Archive collection.
+      Track terms and conditions from websites while learning the basics of declarations, configuration, and metadata.
+    languages: [en]
+    jurisdictions: [EU]
+    ```
+
+### Step 3: Create the configuration file
+
+5. Create a file `config/development.json` and set the tracking schedule to every minute:
+    ```json
+    {
+      "trackingSchedule": "* * * * *"
+    }
+    ```
+
+### Step 4: Install and run the engine
+
+1. Install the Open Terms Archive engine:
+    ```bash
+    npm install --save @opentermsarchive/engine
+    ```
+
+2. Start the scheduled tracking of the declared terms:
+    ```bash
+    npx ota track --schedule
+    ```
+
+3. After one minute, check the results:
+  - Check the extracted version, which should contain the Privacy Policy of Open Terms Archive in the markdown format without insignificant content (like the header, footer, etc.): `./data/versions/Open Terms Archive/Privacy Policy.md`
+  - Check the snapshot, which is the original html document of the Open Terms Archive Privacy Policy: `./data/snapshots/Open Terms Archive/Privacy Policy.html`
+
+Congratulations! You have created your first collection.

content/terms/tutorials/track-terms.md

@@ -5,9 +5,9 @@ weight: 1
 
 # Track your first terms
 
-This tutorial will guide you through creating your first Open Terms Archive collection.
+This tutorial will guide you through tracking your first terms.
 
-By the end, you'll have a working collection that tracks changes to a service's privacy policy. You will also have a basic understanding of how to create a collection and how to set up the API.
+By the end, you'll have tracked a service's privacy policy. You will also have a basic understanding of how to declare a terms to track and how to run the engine.
 
 ## Prerequisites
 
@@ -17,57 +17,63 @@ By the end, you'll have a working collection that tracks changes to a service's
 
 ## Track a terms
 
-### Step 1: Set up the project structure
+### Step 1: Set up the structure
 
-1. Create a new directory for your collection:
-   ```bash
-   mkdir ota-tutorial-declarations
-   cd ota-tutorial-declarations
-   ```
+1. Create a new directory:
+    ```bash
+    mkdir ota-tutorial-declarations
+    cd ota-tutorial-declarations
+    ```
 
-2. Create a `declarations` directory inside your project. This is where you will declare the services and terms you want to track:
-   ```bash
-   mkdir declarations
-   ```
+2. Create a `declarations` directory inside the project. This is where you will declare the service and terms you want to track:
+    ```bash
+    mkdir declarations
+    ```
 
-### Step 2: Create your first service declaration
+### Step 2: Create the service declaration
 
 For this tutorial, we will use the Privacy Policy of Open Terms Archive as an example.
-1. Create a file `declarations/Open Terms Archive.js` with this basic structure, the first thing to declare is the service name:
-   ```json
-   {
-     "name": "Open Terms Archive"
-   }
-   ```
 
-Now, you can add a terms you want to track to the declaration. For this example, we will use the Privacy Policy of Open Terms Archive. 
+1. Create a file `declarations/Open Terms Archive.js` with the basic structure, the first thing to declare is the service name:
+    ```json
+    {
+      "name": "Open Terms Archive"
+    }
+    ```
+
+Now, you can add a terms you want to track to the declaration. For this example, we will use the Privacy Policy of Open Terms Archive.
+
+You can go on the open terms archive website and copy the URL of the Privacy Policy to fill the `fetch` field.
+
+And you can inspect the HTML of the page to get the selector of the content you want to extract to fill the `select` field.
 
 2. Add the Privacy Policy document configuration:
-   ```json
-   {
-     "name": "Open Terms Archive",
-     "documents": {
-       "Privacy Policy": {
-         "fetch": "https://opentermsarchive.org/en/privacy-policy",
-         "select": ".textcontent"
-       }
-     }
-   }
-   ```
+    ```json
+    {
+      "name": "Open Terms Archive",
+      "documents": {
+        "Privacy Policy": {
+          "fetch": "https://opentermsarchive.org/en/privacy-policy",
+          "select": ".textcontent"
+        }
+      }
+    }
+    ```
 
 ### Step 3: Install and run the engine
 
 1. Install the Open Terms Archive engine:
-   ```bash
-   npm install --save @opentermsarchive/engine
-   ```
+    ```bash
+    npm install --save @opentermsarchive/engine
+    ```
 
 2. Start a one time tracking of the declared terms:
-   ```bash
-   npx ota track
-   ```
+    ```bash
+    npx ota track
+    ```
 
 3. Verify the results:
-   - Check the extracted version, which should contain the Privacy Policy of Open Terms Archive in the markdown format without insignificant content (like the header, footer, etc.): `./data/versions/Open Terms Archive/Privacy Policy.md`
-   - Check the snapshot, which is the original html document of the Open Terms Archive Privacy Policy: `./data/snapshots/Open Terms Archive/Privacy Policy.html`
+  - Check the extracted version, which should contain the Privacy Policy of Open Terms Archive in the markdown format without insignificant content (like the header, footer, etc.): `./data/versions/Open Terms Archive/Privacy Policy.md`
+  - Check the snapshot, which is the original html document of the Open Terms Archive Privacy Policy: `./data/snapshots/Open Terms Archive/Privacy Policy.html`
 
+Congratulations! You have tracked your first terms.