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.

content/pages/domain-abstract/index.en.md

@@ -0,0 +1,107 @@
+---
+date: 2021-01-12T21:38:49+02:00
+title: "Using the zone editor"
+author: Frederic
+weight: 900
+description: "View, add, edit and delete records and services in your zone, grouped by subdomain"
+---
+
+The zone editor is the main screen for working with a domain. It presents the content of your zone grouped by subdomain, and lets you add, edit and delete the services and records that make up your zone, all without touching your hosting provider until you decide to [publish changes]({{% relref "publish-changes" %}}).
+
+## The editor layout
+
+When you open a domain, the screen is split in two parts:
+
+- On the left, a **sidebar** lists every subdomain of the zone. It also gives access to domain-wide actions (history, audit log, checks, WHOIS, import/export, etc.).
+- On the right, the **Zone Viewer** displays the content of the zone, one block per subdomain.
+
+![The happyDomain zone editor, with the subdomain sidebar and the zone viewer](happydomain-abstract-zone-records.webp)
+
+At the very top of the sidebar you will find the **Add a subdomain** button and a gear menu grouping the other actions. The button used to send your changes to your provider (**Publish my changes**) is also reachable from here; see [this page]({{% relref "publish-changes" %}}) for details.
+
+{{% notice style="info" title="Nothing is sent automatically" icon="cloud" %}}
+Every change you make in the editor is kept locally in happyDomain. It is only transmitted to your hosting provider once you explicitly publish it.
+{{% /notice %}}
+
+## Browsing the zone
+
+The zone is organised **by subdomain**. The root of the domain is shown first (displayed with the bare domain name), followed by each subdomain. Intermediate subdomains that hold no service of their own are still shown, marked with a dotted icon, so you can always see the full tree.
+
+- Click a subdomain heading to **expand or collapse** it and reveal the services it contains.
+- When a block is collapsed, a badge shows how many services it holds; hover it to get a quick summary.
+- Use the **sidebar** to jump straight to a subdomain: it mirrors the list and scrolls the viewer to the matching block.
+
+Aliases pointing to a subdomain are shown next to its heading with a `+ N aliases` badge.
+
+<!-- TODO: screenshot of a subdomain block expanded, showing its services -->
+
+## Records and services
+
+happyDomain does not show you a raw list of DNS records by default. Instead, it groups related records into **services**, higher-level objects that are easier to reason about (a mail server, a website, a delegation, etc.). Each service expands into the actual records it generates.
+
+If you prefer to work directly with individual records, you can switch the zone view mode in your [account settings]({{% relref "settings" %}}). The editor then offers an **Add a record** button instead of **Add a service**.
+
+## Adding a subdomain
+
+1. Click **Add a subdomain** at the top of the sidebar.
+2. Enter the name of the subdomain to create (relative to your domain).
+3. happyDomain then proposes to add a first service on that subdomain right away.
+
+A subdomain only really exists once it carries at least one service, so the two steps are chained together.
+
+![The add-a-subdomain dialog](happydomain-modal-new-subdomain.webp)
+
+## Adding a service
+
+To add a service to an existing subdomain:
+
+1. Locate the subdomain block (or the domain root) in the viewer.
+2. Click the **+** button on the subdomain heading, or use the **Add a service** action.
+3. Pick the service type from the selector. The list adapts to what already exists on that subdomain (for instance, you cannot add two conflicting services).
+4. Fill in the form for the chosen service, then save.
+
+![The service type selector](happydomain-modal-service-selector.webp)
+
+## Inspecting a service
+
+Click a service to open the **details panel** that slides in from the right. It shows:
+
+- A description of the service type and any comment you set.
+- The concrete DNS records the service produces.
+- The propagation status (when the change was last published).
+- Any health checks attached to that service (see {{% relref "checks" %}}).
+
+From this panel you can also adjust the **default TTL** of the service, edit it, or delete it.
+
+![The service details panel](happydomain-offcanva-service-details.webp)
+
+## Editing a service
+
+1. Open the service details panel, then click **Edit this service**; or use the pencil button shown on simple services such as aliases.
+2. happyDomain opens the full editing form for the service.
+3. Make your changes and save. The viewer refreshes to reflect them.
+
+## Deleting a service
+
+1. Open the service details panel.
+2. Click **Delete this service**.
+
+The service and all the records it generated are removed from your working copy of the zone.
+
+{{% notice style="warning" title="Some services cannot be removed" icon="triangle-exclamation" %}}
+The origin service of a zone (the one carrying the SOA and the authoritative name servers) is essential and cannot be deleted from the editor.
+{{% /notice %}}
+
+For aliases (CNAME) and reverse pointers (PTR), a dedicated delete button is available directly on the subdomain heading.
+
+## Aliases
+
+When a subdomain holds services, you can attach an **alias** to it using the link button on its heading. The alias makes another name resolve to this subdomain.
+
+## Next steps
+
+None of the above changes anything at your hosting provider yet. When you are happy with your edits:
+
+- Review what will change, then send the changes; see {{% relref "publish-changes" %}}.
+
+You can also re-import the live zone, or import/export it as a standard zone file: see {{% relref "import-export" %}}.

content/pages/domain-abstract/index.fr.md

@@ -0,0 +1,106 @@
+---
+date: 2020-12-09T18:12:45+01:00
+title: "Utiliser l'éditeur de zone"
+weight: 900
+description: "Visualiser, ajouter, modifier et supprimer les enregistrements et services de votre zone, regroupés par sous-domaine"
+---
+
+L'éditeur de zone est l'écran principal pour travailler sur un domaine. Il présente le contenu de votre zone regroupé par sous-domaine, et vous permet d'ajouter, modifier et supprimer les services et enregistrements qui composent votre zone, sans rien changer chez votre hébergeur tant que vous n'avez pas décidé de [publier vos changements]({{% relref "publish-changes" %}}).
+
+## Disposition de l'éditeur
+
+Lorsque vous ouvrez un domaine, l'écran est divisé en deux parties :
+
+- À gauche, une **barre latérale** liste tous les sous-domaines de la zone. Elle donne aussi accès aux actions concernant l'ensemble du domaine (historique, journal d'audit, contrôles, WHOIS, import/export, etc.).
+- À droite, le **Visualiseur de zone** affiche le contenu de la zone, un bloc par sous-domaine.
+
+![L'éditeur de zone d'happyDomain, avec la barre latérale des sous-domaines et le visualiseur de zone](happydomain-abstract-zone-records.webp)
+
+Tout en haut de la barre latérale se trouvent le bouton **Ajouter un sous-domaine** et un menu en forme d'engrenage regroupant les autres actions. Le bouton servant à transmettre vos changements à votre hébergeur (« Diffuser mes changements ») est également accessible depuis cet écran ; voyez [cette page]({{% relref "publish-changes" %}}) pour les détails.
+
+{{% notice style="info" title="Rien n'est envoyé automatiquement" icon="cloud" %}}
+Chaque modification que vous faites dans l'éditeur est conservée localement dans happyDomain. Elle n'est transmise à votre hébergeur que lorsque vous la publiez explicitement.
+{{% /notice %}}
+
+## Parcourir la zone
+
+La zone est organisée **par sous-domaine**. La racine du domaine apparaît en premier (affichée avec le nom de domaine seul), suivie de chaque sous-domaine. Les sous-domaines intermédiaires qui ne portent aucun service sont tout de même affichés, signalés par une icône en pointillés, afin que vous puissiez toujours voir l'arborescence complète.
+
+- Cliquez sur le titre d'un sous-domaine pour le **déplier ou le replier** et révéler les services qu'il contient.
+- Lorsqu'un bloc est replié, un badge indique combien de services il contient ; survolez-le pour obtenir un aperçu rapide.
+- Utilisez la **barre latérale** pour accéder directement à un sous-domaine : elle reflète la liste et fait défiler le visualiseur jusqu'au bloc correspondant.
+
+Les alias pointant vers un sous-domaine apparaissent à côté de son titre, sous forme d'un badge « + N alias ».
+
+<!-- TODO: screenshot d'un bloc de sous-domaine déplié, montrant ses services -->
+
+## Enregistrements et services
+
+Par défaut, happyDomain ne vous présente pas une liste brute d'enregistrements DNS. Il regroupe au contraire les enregistrements liés en **services**, des objets de plus haut niveau plus simples à appréhender (un serveur de courrier, un site web, une délégation, etc.). Chaque service se déploie en montrant les enregistrements concrets qu'il génère.
+
+Si vous préférez travailler directement avec les enregistrements individuels, vous pouvez changer le mode d'affichage de la zone dans [vos préférences]({{% relref "settings" %}}). L'éditeur propose alors un bouton **Ajouter un enregistrement** au lieu d'**Ajouter un service**.
+
+## Ajouter un sous-domaine
+
+1. Cliquez sur **Ajouter un sous-domaine** en haut de la barre latérale.
+2. Saisissez le nom du sous-domaine à créer (relatif à votre domaine).
+3. happyDomain vous propose ensuite d'ajouter immédiatement un premier service sur ce sous-domaine.
+
+Un sous-domaine n'existe réellement qu'à partir du moment où il porte au moins un service : les deux étapes sont donc enchaînées.
+
+![La fenêtre d'ajout d'un sous-domaine](happydomain-modal-new-subdomain.webp)
+
+## Ajouter un service
+
+Pour ajouter un service à un sous-domaine existant :
+
+1. Repérez le bloc du sous-domaine (ou la racine du domaine) dans le visualiseur.
+2. Cliquez sur le bouton **+** présent sur le titre du sous-domaine, ou utilisez l'action **Ajouter un service**.
+3. Choisissez le type de service dans le sélecteur. La liste s'adapte à ce qui existe déjà sur ce sous-domaine (par exemple, vous ne pouvez pas ajouter deux services en conflit).
+4. Remplissez le formulaire du service choisi, puis enregistrez.
+
+![Le sélecteur de type de service](happydomain-modal-service-selector.webp)
+
+## Inspecter un service
+
+Cliquez sur un service pour ouvrir le **panneau de détails** qui apparaît par la droite. Il présente :
+
+- Une description du type de service et le commentaire éventuel que vous avez défini.
+- Les enregistrements DNS concrets que le service produit.
+- L'état de propagation (date de la dernière publication de la modification).
+- Les contrôles de santé éventuellement rattachés à ce service (voyez {{% relref "checks" %}}).
+
+Depuis ce panneau, vous pouvez aussi ajuster le **TTL par défaut** du service, le modifier ou le supprimer.
+
+![Le panneau de détails d'un service](happydomain-offcanva-service-details.webp)
+
+## Modifier un service
+
+1. Ouvrez le panneau de détails du service, puis cliquez sur **Modifier ce service** ; ou utilisez le bouton crayon affiché sur les services simples comme les alias.
+2. happyDomain ouvre le formulaire d'édition complet du service.
+3. Effectuez vos changements et enregistrez. Le visualiseur se met à jour pour les refléter.
+
+## Supprimer un service
+
+1. Ouvrez le panneau de détails du service.
+2. Cliquez sur **Supprimer ce service**.
+
+Le service et tous les enregistrements qu'il générait sont retirés de votre copie de travail de la zone.
+
+{{% notice style="warning" title="Certains services ne peuvent pas être supprimés" icon="triangle-exclamation" %}}
+Le service d'origine d'une zone (celui qui porte le SOA et les serveurs de noms faisant autorité) est essentiel et ne peut pas être supprimé depuis l'éditeur.
+{{% /notice %}}
+
+Pour les alias (CNAME) et les pointeurs inverses (PTR), un bouton de suppression dédié est disponible directement sur le titre du sous-domaine.
+
+## Alias
+
+Lorsqu'un sous-domaine porte des services, vous pouvez lui rattacher un **alias** à l'aide du bouton en forme de lien présent sur son titre. L'alias fait pointer un autre nom vers ce sous-domaine.
+
+## Et ensuite
+
+Aucune des opérations ci-dessus ne change quoi que ce soit chez votre hébergeur pour l'instant. Lorsque vos modifications vous conviennent :
+
+- Examinez ce qui va changer, puis envoyez les changements ; voyez {{% relref "publish-changes" %}}.
+
+Vous pouvez aussi réimporter la zone en ligne, ou [l'importer / l'exporter sous forme de fichier de zone standard]({{% relref "import-export" %}}).