# Mise à jour de la documentation "Héberger son serveur avec OpenBSD"
2022-05-20T11:22:38Z

=> /ah/ Je suis ravi d'annoncer aujourd'hui la mise à jour de ma documentation "Héberger son serveur avec OpenBSD".

Ça fait un moment que j'y travaille, et les changements sont conséquents. Petit à petit, page après page, finalement on y arrive en y consacrant quelques heures par semaine.

Pour rappel, l'idée de ce document est de faciliter l'accès à l'auto-hébergement, ou hébergement de façon plus générale si on loue une machine.
Le ton se veut léger de prime abord pour vulgariser des notions parfois complexes, ceci afin de progresser petit à petit.
C'est assez difficile de trouver la note juste entre simplification et contenu technique à détailler selon les cas, mais c'est mon métier et j'aime bien me poser de telles questions.

Évidemment, j'aimerais aller encore plus loin, donc vos retours à ce propos sont précieux 😉.

Les changements sont nombreux, voici donc dans un premier temps les plus importants pour moi : 

* Mise à jour des instructions pour OpenBSD 7.1, dernière en date.
* Création d'une page contenant toouuute la documentation afin de pouvoir être imprimée dans un PDF. Le code CSS est spécialement prévu pour. Merci f6k pour les bouts de code bien pratiques 😉.
* Traduction en Anglais !!! J'en reparlerai, mais c'est un évènement pour moi 😃. Ce travail de traduction m'a aidé à reformuler des phrases inutiliement complexes. Faire l'effort de traduire dans une langue qui n'est pas la mienne demande de se questionner sur les tournures à utiliser et éclaire sur des formulations mladroites. Il reste certainement des tas d'erreurs de traduction et de coquilles, mais cette traduction a le mérite d'exister, je pourrai construire dessus.

Sinon, voici une liste d'autres changements moins importants : 

* Tout est rédigé au format gemtext. C'est du texte lisible, pratique, qui force à être clair et plus structuré.
* Tout est exportéxhtml : permet de repérer les erreurs, et prévoit un éventuel export en EPUB un jour.
* Utilisation de gmi2xhtml.awk pour convertir en XHTML peu importe le système utilisé.
* Ajout d'une page pour gérer une liste de diffusion avec mlmmj.
* Ajout d'un guide de survie sous OpenBSD.
* Simplification de la partie sur le réseau.
* Proposition d'installation chiffrée par defaut.
* Guide de ce qu'il faut faire juste après l'installation.
* Ajout de détails sur /etc/fstab.
* Suppression de plusieurs images inutiles ou datées. Certaines étaient corrompues.
* Remplacement d'images par des diagrammes ascii.
* Amélioration du code CSS pour l'impression. Les liens sont maintenant clairement indiqués pour recopier.
* Un mode dark est disponible.
* Génération automatique d'une page de sommaire.
* Ajout d'éléments de sécurité pour le serveur gopher geomyidae
* Ajjout d'une page sur le serveur gemini vger
* Ajout d'une page sur iblock (pf) pour bloquer les scanneurs (merci solene)
* Ajout d'une page "contributing"
* Ajout d'instructions pour un serveur XMPP.
* Des typos, des typos et encore des typos...
* Suppression de la majorité du contenu de la page "Exemple de service WEB". C'était répétitif, et présentait le risque d'être peu à jour.
* Étayage de la partie sur les principes généraux du DNS pour rendre certains paragraphes plus accessibles. Corrections de quelques erreurs. Ajouts de mentions sur les enregistrements TXT.
* Simplification de la partie trucs et astuces puisque des éléments étaient redondants.
* Tout ce que je n'ai pas noté au fur et à mesure... 😇

Et la suite me direz-vous?

Je compte bien maintenir à jour cette documentation.
J'aimerais aussi ajouter des instructions pour un résolveur DNS public (unboud) et la publication automatique d'enregistrements TLSA. C'est très technique, peut-être trop. Par ailleurs, j'ai envie d'ajouter des explications pour aider à créer une page web, comment écrire du bête html ou publier une capsule gemini pas à pas. C'est à la limite du cadre là aussi, car peut-être trop simple. J'hésite, je réfléchis...

## Une réaction?

=> mailto:bla@bla.si3t.ch?subject=ah-mise-a-jour-2022 Envoyez votre commentaire par mail.
=> /log/commentaires/ Mode d'emploi de la liste de diffusion pour recevoir les réponses.