Cette catégorie regroupe l’ensemble de la documentation technique de La Contre-Voie.
Objectifs🔗
Nous avons pensé notre documentation pour répondre aux besoins suivants :
- Servir de support interne pour nos interventions techniques, pour que nos bénévoles habilité·es puissent découvrir notre infrastructure et s’approprier les spécificités de notre stack technique ;
- Offrir un témoignage pour les autres structures (notamment du collectif CHATONS) sur la maintenabilité de nos services sur le long terme afin qu’iels puissent évaluer (sur la base de différentes métriques mises à disposition) si leur organisation dispose des moyens humains et techniques pour garantir un bon niveau de service ;
- Servir de trace sur les évolutions évenutelles envisagées pour l’amélioration de nos services.
Ce que vous trouverez dans cette catégorie🔗
- Des statistiques d’utilisation précises de chacun de nos services, sur une base journalière et sur plusieurs années :
- Du trafic reçu, en nombre de bénéficiaires (visiteur·ices uniques par jour) et en bande passante ;
- De la consommation moyenne en RAM ;
- De l’usage de l’espace disque pour chaque volume, y compris pour les bases de données ;
- Des informations sur nos politiques internes quant à l’entretien et la modération de nos services ;
- Un historique de la maintenance de chaque service qui donne un aperçu des changements techniques opérés avec le temps pour assurer la pérennité du service et du raisonnement qui nous a mené·es à proposer ce service ;
- Les liens vers les codes source de chaque outil que nous utilisons en production ;
- Des précautions à prendre pour héberger un service particulier, basées sur notre expérience (et notamment, nos propres erreurs) ;
- Un guide d’entretien et de mise à jour de nos outils spécifiquement orienté pour nos besoins et notre infrastructure ;
- Le détail des modifications structurelles que nous envisageons dans la perspective d’améliorer la qualité de service.
Ce que vous ne trouverez pas dans cette catégorie🔗
- Des instructions d’installation pas-à-pas : nous vous référons à la documentation officielle des logiciels que nous hébergeons, qui sera plus complète et tenue à jour ;
- Des guides de maintenance génériques : nos guides de maintenance sont rédigés pour notre association, selon notre politique de modération et adaptés pour notre environnement et nos besoins. Si vous souhaitez héberger un service que nous hébergeons, il vous revient de juger du contenu de nos guides de maintenance et de les adapter pour votre infrastructure.
- Des contenus accessibles pour des publics non-initiés : cette catégorie de notre documentation est consacrée à notre environnement technique, nous partons donc du principe que vous disposez de connaissances de base dans l’hébergement de services et le déploiement d’applications sur un serveur.
Si vous avez des remarques concernant un contenu manquant, une information inexacte ou des sections à améliorer, n’hésitez pas à prendre contact avec nous.