docs: restructure help pages into bundles and add new reference pages
Convert several pages to leaf bundles with WebP screenshots, add api-keys, domain-availability, notifications, provider-features, quotas, services, settings, signup and subdomains pages, and refresh existing content.
This commit is contained in:
parent
6b6a8c847f
commit
c372f8409a
81 changed files with 1957 additions and 155 deletions
BIN
content/pages/services/happydomain-abstract-zone-records.webp
Normal file
BIN
content/pages/services/happydomain-abstract-zone-records.webp
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 75 KiB |
BIN
content/pages/services/happydomain-modal-service-selector.webp
Normal file
BIN
content/pages/services/happydomain-modal-service-selector.webp
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 42 KiB |
86
content/pages/services/index.en.md
Normal file
86
content/pages/services/index.en.md
Normal file
|
|
@ -0,0 +1,86 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Services
|
||||
author: nemunaire
|
||||
weight: 1200
|
||||
description: "Understand how happyDomain turns raw DNS records into high-level services, and how to add one to a subdomain"
|
||||
---
|
||||
|
||||
happyDomain does not ask you to think in terms of individual DNS records. Instead, it groups the records that belong together into a single, meaningful **service**: a mailbox, a website, a delegation, a CAA policy, and so on. This is the foundation of the [abstract view]({{% relref "domain-abstract" %}}) of your zone.
|
||||
|
||||
## What is a service?
|
||||
|
||||
A service is a higher-level object that hides the complexity of one or several DNS records behind a clear, purpose-driven form.
|
||||
|
||||
For example, instead of editing a raw `MX` record, a couple of `A`/`AAAA` records and an `SPF` `TXT` record separately, you fill in a single **email** service. happyDomain takes care of generating the right records, with the right names and the right syntax.
|
||||
|
||||
Each service belongs to a family:
|
||||
|
||||
- **Services** (abstract): the recommended, human-friendly objects (email, website, CAA, delegation, ...). They map to one or more records automatically.
|
||||
- **Providers**: services tied to a specific third party that publishes its own helper (for example a hosted service that needs a predefined set of records).
|
||||
- **Raw DNS resources**: a fallback that lets you add a single record (`A`, `TXT`, `SRV`, ...) directly, when no abstract service fits your need.
|
||||
|
||||
{{% notice style="info" title="Why services instead of records?" icon="lightbulb" %}}
|
||||
Working with services means you do not have to remember the exact record types, their order, or their syntax. happyDomain validates your input and generates valid DNS for you, which greatly reduces the risk of a misconfiguration.
|
||||
{{% /notice %}}
|
||||
|
||||
## The service view of a subdomain
|
||||
|
||||
When you open a domain, each subdomain is displayed as a list of the services attached to it. A subdomain can hold several services at once: for instance the apex (`@`) of a domain often carries an email service, a website service and a CAA policy together.
|
||||
|
||||

|
||||
|
||||
From this view you can:
|
||||
|
||||
- **Add** a new service to the subdomain.
|
||||
- **Edit** an existing service to change its values.
|
||||
- **Delete** a service you no longer need.
|
||||
|
||||
All these changes are staged locally and only applied to your provider when you publish them. See the [abstract view]({{% relref "domain-abstract" %}}) for how editing and propagation work.
|
||||
|
||||
## Adding a service to a subdomain
|
||||
|
||||
To attach a new service, start from the subdomain where you want it (see [Subdomains]({{% relref "subdomains" %}}) for navigating the zone), then follow these steps.
|
||||
|
||||
### 1. Open the service selector
|
||||
|
||||
Click the **Add service** action on the subdomain. A selector opens, listing every service type you can add.
|
||||
|
||||

|
||||
|
||||
The selector is organised in tabs so you can narrow down the list:
|
||||
|
||||
- **All**: every available service type.
|
||||
- **Services**: the abstract, high-level services (recommended).
|
||||
- **Providers**: services specific to a provider.
|
||||
- **Raw DNS resources**: a single record type when you need full control.
|
||||
|
||||
You can also type in the search box at the top to filter the list by name. Pressing Enter selects the first available match.
|
||||
|
||||
{{% notice style="tip" title="Greyed-out entries" icon="circle-info" %}}
|
||||
Some service types may appear disabled. This happens when the service cannot be added in the current context: for example because your DNS provider does not support the underlying record type, or because that service already exists on this subdomain and only one instance is allowed. Hover over a disabled entry to see the reason.
|
||||
{{% /notice %}}
|
||||
|
||||
### 2. Choose the service type
|
||||
|
||||
Select the service that matches what you want to publish. happyDomain knows which record types your provider supports, so only the relevant choices are offered. To check what a given provider can handle, see the [Provider features]({{% relref "provider-features" %}}) page.
|
||||
|
||||
### 3. Fill in the service form
|
||||
|
||||
happyDomain then presents a form tailored to the chosen service. Each field corresponds to a meaningful piece of information (a target host, a priority, a public key, a policy value, ...) rather than to raw record syntax.
|
||||
|
||||
<!-- TODO: screenshot of a service edit form -->
|
||||
|
||||
Fill in the fields, then confirm to add the service to the subdomain.
|
||||
|
||||
### 4. Review the generated records
|
||||
|
||||
Once the form is validated, happyDomain converts your input into the corresponding DNS records and adds them to the staged zone. You can review them in the [abstract view]({{% relref "domain-abstract" %}}) before publishing your changes to your provider.
|
||||
|
||||
## Trying services without an account
|
||||
|
||||
happyDomain also offers a public **record generator** where you can build and preview the DNS records produced by a service without signing in. Pick a service type, enter a domain name, fill in the form, and the generated zone-file entries are displayed instantly.
|
||||
|
||||
This is a handy way to discover how a given service maps to actual DNS records, or to grab a record you will paste elsewhere.
|
||||
|
||||
<!-- TODO: screenshot of the public record generator -->
|
||||
85
content/pages/services/index.fr.md
Normal file
85
content/pages/services/index.fr.md
Normal file
|
|
@ -0,0 +1,85 @@
|
|||
---
|
||||
date: 2026-06-10T12:00:00+02:00
|
||||
title: Services
|
||||
weight: 1200
|
||||
description: "Comprendre comment happyDomain transforme les enregistrements DNS bruts en services de haut niveau, et comment en ajouter un à un sous-domaine"
|
||||
---
|
||||
|
||||
happyDomain ne vous demande pas de raisonner en termes d'enregistrements DNS individuels. À la place, il regroupe les enregistrements qui vont ensemble au sein d'un unique **service** porteur de sens : une messagerie, un site web, une délégation, une politique CAA, etc. C'est le fondement de la [vue abstraite]({{% relref "domain-abstract" %}}) de votre zone.
|
||||
|
||||
## Qu'est-ce qu'un service ?
|
||||
|
||||
Un service est un objet de plus haut niveau qui masque la complexité d'un ou de plusieurs enregistrements DNS derrière un formulaire clair, orienté usage.
|
||||
|
||||
Par exemple, au lieu d'éditer séparément un enregistrement `MX`, quelques enregistrements `A`/`AAAA` et un enregistrement `SPF` de type `TXT`, vous remplissez un seul service **messagerie**. happyDomain se charge de générer les bons enregistrements, avec les bons noms et la bonne syntaxe.
|
||||
|
||||
Chaque service appartient à une famille :
|
||||
|
||||
- **Services** (abstraits) : les objets recommandés, pensés pour les humains (messagerie, site web, CAA, délégation, etc.). Ils se traduisent automatiquement en un ou plusieurs enregistrements.
|
||||
- **Fournisseurs** : des services liés à un acteur tiers précis qui publie son propre assistant (par exemple un service hébergé nécessitant un ensemble d'enregistrements prédéfini).
|
||||
- **Ressources DNS brutes** : une solution de repli qui vous permet d'ajouter directement un enregistrement unique (`A`, `TXT`, `SRV`, etc.), lorsqu'aucun service abstrait ne correspond à votre besoin.
|
||||
|
||||
{{% notice style="info" title="Pourquoi des services plutôt que des enregistrements ?" icon="lightbulb" %}}
|
||||
Travailler avec des services vous évite d'avoir à mémoriser les types d'enregistrements exacts, leur ordre ou leur syntaxe. happyDomain valide votre saisie et génère du DNS correct à votre place, ce qui réduit fortement le risque d'erreur de configuration.
|
||||
{{% /notice %}}
|
||||
|
||||
## La vue par services d'un sous-domaine
|
||||
|
||||
Lorsque vous ouvrez un domaine, chaque sous-domaine est présenté sous la forme d'une liste des services qui lui sont rattachés. Un sous-domaine peut accueillir plusieurs services à la fois : par exemple, la racine (`@`) d'un domaine porte souvent à la fois un service de messagerie, un service de site web et une politique CAA.
|
||||
|
||||

|
||||
|
||||
Depuis cette vue, vous pouvez :
|
||||
|
||||
- **Ajouter** un nouveau service au sous-domaine ;
|
||||
- **Modifier** un service existant pour en changer les valeurs ;
|
||||
- **Supprimer** un service dont vous n'avez plus besoin.
|
||||
|
||||
Toutes ces modifications sont préparées localement et ne sont appliquées chez votre hébergeur qu'au moment de leur publication. Consultez la [vue abstraite]({{% relref "domain-abstract" %}}) pour comprendre le fonctionnement de l'édition et de la propagation.
|
||||
|
||||
## Ajouter un service à un sous-domaine
|
||||
|
||||
Pour rattacher un nouveau service, placez-vous sur le sous-domaine où vous le souhaitez (voir [Sous-domaines]({{% relref "subdomains" %}}) pour naviguer dans la zone), puis suivez ces étapes.
|
||||
|
||||
### 1. Ouvrir le sélecteur de services
|
||||
|
||||
Cliquez sur l'action **Ajouter un service** du sous-domaine. Un sélecteur s'ouvre, listant tous les types de services que vous pouvez ajouter.
|
||||
|
||||

|
||||
|
||||
Le sélecteur est organisé en onglets pour vous aider à restreindre la liste :
|
||||
|
||||
- **Tous** : tous les types de services disponibles.
|
||||
- **Services** : les services abstraits de haut niveau (recommandé).
|
||||
- **Fournisseurs** : les services spécifiques à un fournisseur.
|
||||
- **Ressources DNS brutes** : un type d'enregistrement unique, lorsque vous avez besoin d'un contrôle total.
|
||||
|
||||
Vous pouvez également saisir un terme dans le champ de recherche, en haut, pour filtrer la liste par nom. Appuyer sur Entrée sélectionne le premier résultat disponible.
|
||||
|
||||
{{% notice style="tip" title="Entrées grisées" icon="circle-info" %}}
|
||||
Certains types de services peuvent apparaître désactivés. Cela se produit lorsque le service ne peut pas être ajouté dans le contexte actuel : par exemple parce que votre hébergeur DNS ne prend pas en charge le type d'enregistrement sous-jacent, ou parce que ce service existe déjà sur ce sous-domaine et qu'une seule instance est autorisée. Survolez une entrée désactivée pour en connaître la raison.
|
||||
{{% /notice %}}
|
||||
|
||||
### 2. Choisir le type de service
|
||||
|
||||
Sélectionnez le service correspondant à ce que vous souhaitez publier. happyDomain connaît les types d'enregistrements pris en charge par votre hébergeur : seuls les choix pertinents vous sont donc proposés. Pour savoir ce qu'un hébergeur donné sait gérer, consultez la page [Fonctionnalités des fournisseurs]({{% relref "provider-features" %}}).
|
||||
|
||||
### 3. Remplir le formulaire du service
|
||||
|
||||
happyDomain présente alors un formulaire adapté au service choisi. Chaque champ correspond à une information porteuse de sens (un hôte cible, une priorité, une clé publique, une valeur de politique, etc.) plutôt qu'à de la syntaxe d'enregistrement brute.
|
||||
|
||||
<!-- TODO: capture d'écran d'un formulaire d'édition de service -->
|
||||
|
||||
Renseignez les champs, puis validez pour ajouter le service au sous-domaine.
|
||||
|
||||
### 4. Vérifier les enregistrements générés
|
||||
|
||||
Une fois le formulaire validé, happyDomain convertit votre saisie en enregistrements DNS correspondants et les ajoute à la zone en préparation. Vous pouvez les vérifier dans la [vue abstraite]({{% relref "domain-abstract" %}}) avant de publier vos modifications chez votre hébergeur.
|
||||
|
||||
## Essayer les services sans compte
|
||||
|
||||
happyDomain propose également un **générateur d'enregistrements** public qui vous permet de construire et de prévisualiser les enregistrements DNS produits par un service sans être connecté. Choisissez un type de service, saisissez un nom de domaine, remplissez le formulaire : les entrées de fichier de zone générées s'affichent instantanément.
|
||||
|
||||
C'est un moyen pratique de découvrir comment un service donné se traduit en véritables enregistrements DNS, ou de récupérer un enregistrement à coller ailleurs.
|
||||
|
||||
<!-- TODO: capture d'écran du générateur d'enregistrements public -->
|
||||
Loading…
Add table
Add a link
Reference in a new issue