docs: update documentation

docs/astro.config.mjs

@@ -40,6 +40,7 @@ export default defineConfig({
                     label: 'Developing',
                     items: [
                         {slug: 'developing/technical-stack'},
+                        {slug: 'developing/add-provider'},
                         {slug: 'developing/translation'},
                         {label: 'Contributing', autogenerate: {directory: 'developing/contributing'}}
                     ],

docs/src/content/docs/en/features/backorder/connector.mdx

@@ -2,12 +2,17 @@
 title: Connector
 ---
 
+import {LinkCard} from '@astrojs/starlight/components';
+
 A Connector allows Domain Watchdog to communicate with an external domain registrar’s API to perform actions such as
 domain registration.
 
 ## Create a Connector
 
-1. Choose an external API provider from the list of [supported registrars](../supported-registrar)
+1. Choose an external API provider from the list of supported registrars.
+
+<LinkCard title="Supported registrar" description="List of supported registrars for creating a Connector" href="../supported-registrar"/>
+
 2. Enter the required information using the credentials obtained from your provider’s customer area
 
 :::tip{icon="heart"}
@@ -30,7 +35,6 @@ In particular, you must consent to:
 
 - Accept the provider’s API Terms of Use
 - Confirm that you are of legal age to accept these terms
-- Waive any right of withdrawal, as domain names are reserved immediately and made available to you
 
 Since the terms of use may change at any time, the link to these terms is always accessible on the page listing the
 Connectors.

docs/src/content/docs/en/features/backorder/supported-registrar.mdx

@@ -2,6 +2,8 @@
 title: Supported registrar
 ---
 
+import {LinkButton} from '@astrojs/starlight/components';
+
 :::caution[Reminder]
 
 * Please note that this project is NOT affiliated IN ANY WAY with the API Providers used to order domain names.
@@ -21,6 +23,13 @@ title: Supported registrar
 | Subsidiary     | the country linked to the OVH subsidiary associated with your account            | Required |
 | Pricing mode   | choose whether you want to pay for a Premium domain name or only standard prices | Required |
 
+<LinkButton variant="secondary"
+            icon="external"
+            target="_blank"
+            href="https://api.ovh.com/createToken/?GET=/order/cart&GET=/order/cart/*&POST=/order/cart&POST=/order/cart/*&DELETE=/order/cart/*&GET=/domain/extensions">
+    Retrieve my token from the OVH website
+</LinkButton>
+
 ## Gandi
 
 | Field      | Description                                                      | Required |
@@ -28,6 +37,13 @@ title: Supported registrar
 | Token      | your account authentication token                                | Required | 
 | Sharing ID | indicates the organization that will pay for the ordered product | Optional |
 
+<LinkButton variant="secondary"
+            icon="external"
+            target="_blank"
+            href="https://admin.gandi.net/organizations/account/pat">
+    Retrieve my token from the Gandi website
+</LinkButton>
+
 ## Namecheap
 
 :::caution
@@ -40,6 +56,13 @@ connection. This information must also be entered in the configuration.
 | API user | the API user as given by the Provider | Required | 
 | API key  | the API key as given by the Provider  | Required |
 
+<LinkButton variant="secondary"
+            icon="external"
+            target="_blank"
+            href="https://ap.www.namecheap.com/settings/tools/apiaccess/">
+    Retrieve my token from the Namecheap website
+</LinkButton>
+
 ## AutoDNS
 
 :::caution
@@ -55,6 +78,13 @@ supported.
 | Context       | the "context" as given by the Provider                        | Required |
 | Contact ID    | Contact ID of the domain name holder of the purchased domains | Required |
 
+<LinkButton variant="secondary"
+            icon="external"
+            target="_blank"
+            href="https://en.autodns.com/domain-robot-api/">
+    Retrieve my token from the AutoDNS website
+</LinkButton>
+
 ## Name.com
 
 :::caution
@@ -67,6 +97,13 @@ supported.
 | Username | the account username              | Required |
 | Token    | your account authentication token | Required |
 
+<LinkButton variant="secondary"
+            icon="external"
+            target="_blank"
+            href="https://www.name.com/account/settings/api">
+    Retrieve my token from the Name.com website
+</LinkButton>
+
 ## Custom EPP server
 
 This type of connector allows you to directly link your instance to a registry via the EPP protocol.

docs/src/content/docs/en/features/index.md

@@ -22,8 +22,3 @@ A confirmation email will be sent to you to verify your email address.
 ## Create a Watchlist
 
 ## Create a Connector
-
-## TLD list
-
-## ICANN-accredited registrar list
-

docs/src/content/docs/en/features/search/icann-registrar-list.md

@@ -0,0 +1,3 @@
+---
+title: ICANN Registrar list
+---

docs/src/content/docs/en/features/search/tld-list.md

@@ -0,0 +1,3 @@
+---
+title: TLD list
+---

docs/src/content/docs/en/features/tracking/watchlist.md

@@ -5,11 +5,11 @@ title: Watchlist
 A Watchlist is a list of domain names, triggers and possibly an API connector. They allow you to follow the life of the
 listed domain names and send you a notification when a change has been detected.
 
-If a domain has expired and a connector is linked to the Watchlist, then Domain Watchdog will try to order it via the
+If a domain has expired and a connector is linked to the Watchlist, then an order attempt will be made though the
-connector provider's API.
+Connector provider's API.
 
 :::note
-If the same domain name is present on several Watchlists, on the same principle as the raise condition, it is not
+If the same domain name is present on several Watchlists, on the same principle as the race condition, it is not
 possible to predict in advance which user will win the domain name. The choice is left to chance...
 :::
 
@@ -25,7 +25,5 @@ Now, it's your turn to create a Watchlist!
 
 ## Limitations
 
-Depending on the instance configuration, there are several limitations to frame user behavior:
+Depending on the instance configuration, there are several limitations to frame user behavior.
 
-* `LIMIT_MAX_WATCHLIST` : Maximum number of Watchlists that can be created
-* `LIMIT_MAX_WATCHLIST_DOMAINS` : Maximum number of domain names for each Watchlist

docs/src/content/docs/en/self-hosting/configuration.mdx

@@ -4,7 +4,6 @@ title: Configuration
 
 import {LinkCard} from '@astrojs/starlight/components';
 
-## Docker
 <LinkCard title="Install with Docker" href="../docker-install"/>
 
 ## Environment variables

docs/src/content/docs/en/self-hosting/docker-install.mdx

@@ -2,9 +2,12 @@
 title: Install with Docker
 ---
 
-1. Download the [docker-compose.yml](https://github.com/maelgangloff/domain-watchdog/blob/develop/docker-compose.yml)
+import {LinkCard} from '@astrojs/starlight/components';
-   and modify it as needed
+
+1. Download the [docker-compose.yml](https://github.com/maelgangloff/domain-watchdog/blob/develop/docker-compose.yml) and modify it as needed
 2. Download the [.env](https://github.com/maelgangloff/domain-watchdog/blob/develop/.env) and modify it as needed
+<LinkCard title="Configuration" description="List of environment variables" href="../configuration/#environment-variables"/>
+
 3. Add static files to customize your instance (under `public/content`)
 4. Pull the latest version of the Domain Watchdog image from Docker Hub
 
@@ -19,3 +22,4 @@ docker compose up
 ```
 
 By default, the container listens on http://localhost:8080, but you can configure this in environment variables.
+

docs/src/content/docs/en/self-hosting/manual-install.mdx

@@ -2,6 +2,8 @@
 title: Manual Install
 ---
 
+import {LinkCard} from '@astrojs/starlight/components';
+
 ## Installation
 
 To deploy a Domain Watchdog instance, please refer to the Symfony documentation
@@ -35,6 +37,9 @@ git clone https://github.com/maelgangloff/domain-watchdog.git
 ```shell
 cp .env .env.local
 ```
+
+<LinkCard title="Configuration" description="List of environment variables" href="../configuration"/>
+
 3. Generate the cryptographic key pair for the JWT signature
 ```shell
 php bin/console lexik:jwt:generate-keypair