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:
nemunaire 2026-06-11 16:50:06 +09:00
commit c372f8409a
81 changed files with 1957 additions and 155 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 75 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.1 KiB

View file

@ -0,0 +1,66 @@
---
date: 2026-06-10T12:00:00+02:00
title: Subdomains
author: nemunaire
weight: 1100
description: "Navigate and manage the subdomains of a domain: the subdomain list, the tree view, and how to create a new subdomain path"
---
A domain is rarely flat: it is made of a root (the apex, written `@`) and a hierarchy of subdomains such as `www`, `mail`, or `blog.staging`. happyDomain presents this hierarchy in a clear, navigable way so you can quickly find and manage each part of your zone.
## The subdomain list
When you open a domain, the left sidebar shows the list of subdomains for the currently selected zone version. Each entry is displayed as a path relative to the domain, with the apex shown as the domain name itself.
![The sidebar listing the subdomains of the domain](happydomain-abstract-zone-records.webp)
The list behaves like a table of contents:
- It is **indented** to reflect the hierarchy: a subdomain is shifted to the right according to its depth in the tree, so `blog.staging` appears nested under `staging`.
- Clicking an entry **scrolls** the main panel to the corresponding subdomain.
- As you scroll through the zone, the sidebar **highlights** the subdomain you are currently looking at and follows along automatically.
Intermediate levels that do not carry any service of their own are still shown, so the tree remains coherent and easy to read. (For reverse zones, only the actual entries are listed.)
## Managing a subdomain
Each subdomain in the main panel groups the [services]({{% relref "services" %}}) attached to it. From there you can add, edit, or remove services. Adding a service to an existing subdomain is covered in detail in [Services]({{% relref "services#adding-a-service-to-a-subdomain" %}}).
## Creating a new subdomain path
To create a brand-new subdomain (one that does not exist yet in your zone), use the **Add a subdomain** action at the top of the sidebar.
<!-- TODO: screenshot of the Add a subdomain button -->
### 1. Enter the subdomain name
A dialog opens asking for the new subdomain to create under your domain. Type the name **relative to the domain**: for example, enter `www` to create `www.example.com`, or `blog.staging` to create a nested path in one step.
![The new-subdomain creation dialog](happydomain-modal-new-subdomain.webp)
The name is validated as you type. You only need to provide the part to the left of your domain name; happyDomain appends the domain for you.
{{% notice style="tip" title="Apex and nested paths" icon="sitemap" %}}
Leave the field empty (or use `@`) to target the domain apex itself. You can also create several levels at once by typing a dotted path such as `a.b.c`: the intermediate levels are created as needed.
{{% /notice %}}
### 2. Add a first service
Creating a subdomain only makes sense if it carries at least one service, so happyDomain chains directly into the service selector once you confirm the name. Pick the service type and fill in its form exactly as described in [Services]({{% relref "services" %}}).
The new subdomain then appears in the sidebar and in the main panel, with the service you just added.
{{% notice style="info" title="Changes are staged" icon="circle-info" %}}
Creating a subdomain and its service does not contact your DNS provider immediately. Like every other change, it is staged locally and only sent to your provider when you publish the zone. See the [abstract view]({{% relref "domain-abstract" %}}) for how to review and apply your changes.
{{% /notice %}}
## Other domain actions
Next to the **Add a subdomain** button, a menu gives access to domain-wide actions, including:
- viewing the [history]({{% relref "domain-history" %}}) of zone versions;
- consulting the audit log of changes;
- configuring [checks]({{% relref "checks" %}}) for the domain;
- running a WHOIS lookup;
- viewing or re-importing the zone, or uploading a zone file;
- removing the domain from happyDomain.

View file

@ -0,0 +1,65 @@
---
date: 2026-06-10T12:00:00+02:00
title: Sous-domaines
weight: 1100
description: "Naviguer et gérer les sous-domaines d'un domaine : la liste des sous-domaines, la vue en arbre et la création d'un nouveau sous-domaine"
---
Un domaine est rarement plat : il se compose d'une racine (l'apex, noté `@`) et d'une hiérarchie de sous-domaines tels que `www`, `mail` ou `blog.staging`. happyDomain présente cette hiérarchie de façon claire et navigable, afin que vous puissiez retrouver et gérer rapidement chaque partie de votre zone.
## La liste des sous-domaines
Lorsque vous ouvrez un domaine, la barre latérale de gauche affiche la liste des sous-domaines pour la version de zone sélectionnée. Chaque entrée est présentée sous la forme d'un chemin relatif au domaine, l'apex étant affiché sous la forme du nom de domaine lui-même.
![La barre latérale listant les sous-domaines du domaine](happydomain-abstract-zone-records.webp)
Cette liste se comporte comme une table des matières :
- elle est **indentée** pour refléter la hiérarchie : un sous-domaine est décalé vers la droite en fonction de sa profondeur dans l'arbre, si bien que `blog.staging` apparaît imbriqué sous `staging` ;
- cliquer sur une entrée **fait défiler** le panneau principal jusqu'au sous-domaine correspondant ;
- au fil de votre défilement dans la zone, la barre latérale **met en évidence** le sous-domaine que vous consultez et suit automatiquement votre position.
Les niveaux intermédiaires qui ne portent aucun service propre restent affichés, de sorte que l'arbre demeure cohérent et facile à lire. (Pour les zones inverses, seules les entrées réelles sont listées.)
## Gérer un sous-domaine
Dans le panneau principal, chaque sous-domaine regroupe les [services]({{% relref "services" %}}) qui lui sont rattachés. Vous pouvez y ajouter, modifier ou supprimer des services. L'ajout d'un service à un sous-domaine existant est détaillé dans la page [Services]({{% relref "services#ajouter-un-service-à-un-sous-domaine" %}}).
## Créer un nouveau sous-domaine
Pour créer un sous-domaine entièrement nouveau (qui n'existe pas encore dans votre zone), utilisez l'action **Ajouter un sous-domaine**, en haut de la barre latérale.
<!-- TODO: capture d'écran du bouton « Ajouter un sous-domaine » -->
### 1. Saisir le nom du sous-domaine
Une fenêtre s'ouvre et vous demande le nouveau sous-domaine à créer sous votre domaine. Saisissez le nom **relatif au domaine** : par exemple, entrez `www` pour créer `www.example.com`, ou `blog.staging` pour créer un chemin imbriqué en une seule fois.
![La fenêtre de création d'un sous-domaine](happydomain-modal-new-subdomain.webp)
Le nom est validé au fur et à mesure de la saisie. Vous n'avez besoin de fournir que la partie située à gauche de votre nom de domaine ; happyDomain ajoute le domaine pour vous.
{{% notice style="tip" title="Apex et chemins imbriqués" icon="sitemap" %}}
Laissez le champ vide (ou utilisez `@`) pour viser la racine du domaine elle-même. Vous pouvez aussi créer plusieurs niveaux d'un coup en saisissant un chemin avec des points, comme `a.b.c` : les niveaux intermédiaires sont créés au besoin.
{{% /notice %}}
### 2. Ajouter un premier service
Créer un sous-domaine n'a de sens que s'il porte au moins un service : happyDomain enchaîne donc directement avec le sélecteur de services dès que vous confirmez le nom. Choisissez le type de service et remplissez son formulaire exactement comme décrit dans la page [Services]({{% relref "services" %}}).
Le nouveau sous-domaine apparaît alors dans la barre latérale et dans le panneau principal, avec le service que vous venez d'ajouter.
{{% notice style="info" title="Les modifications sont préparées" icon="circle-info" %}}
Créer un sous-domaine et son service ne contacte pas immédiatement votre hébergeur DNS. Comme toute autre modification, l'opération est préparée localement et n'est envoyée à votre hébergeur qu'au moment de la publication de la zone. Consultez la [vue abstraite]({{% relref "domain-abstract" %}}) pour savoir comment vérifier et appliquer vos modifications.
{{% /notice %}}
## Autres actions sur le domaine
À côté du bouton **Ajouter un sous-domaine**, un menu donne accès aux actions concernant l'ensemble du domaine, notamment :
- consulter l'[historique]({{% relref "domain-history" %}}) des versions de la zone ;
- consulter le journal d'audit des modifications ;
- configurer les [vérifications]({{% relref "checks" %}}) du domaine ;
- effectuer une recherche WHOIS ;
- afficher ou réimporter la zone, ou téléverser un fichier de zone ;
- retirer le domaine de happyDomain.