Comment les sources sont choisies
Les guides citent des sources pour les affirmations sur des produits tiers, des normes et l’histoire. Nous privilégions :
- Les sources primaires. Organismes de normalisation, pages de spécifications et documentation des éditeurs.
- Les mainteneurs. Pages de projet et notes de version de ceux qui développent les logiciels.
- Les références neutres. Centres de documentation comme MDN et registres comme celui de l’ICC.
Nous évitons les blogs qui répètent des affirmations, les sites de comparaison qui n’exposent pas leur méthode et les pages d’outils concurrents.
Comment les sources sont utilisées
- Chaque affirmation doit être traçable. Les guides renvoient à la source dans le texte, à côté de l’affirmation.
- Nous lisons la source avant de la citer. Si nous ne pouvons pas lire une source, par exemple une page qui exige JavaScript ou bloque l’accès automatisé, le guide le dit et vous invite à la vérifier vous-même.
- Nous n’inventons pas de chiffres. Les pourcentages, numéros de version et dates n’apparaissent que si une source les donne.
- Des tableaux à jour pour les faits qui changent. La prise en charge par les navigateurs renvoie vers un tableau de compatibilité à jour plutôt que d’être recopiée.
- Uniquement les sources listées. Les guides ne peuvent citer que les sources de la liste ci-dessous. En ajouter une est un acte délibéré, consigné dans le Journal des modifications.
Lacunes connues
Certains éditeurs, notamment Adobe et Shopify, publient des pages d’aide que les outils automatiques ne peuvent pas lire. À ces endroits, les guides n’avancent rien et vous renvoient vers la documentation actuelle de l’éditeur.
Corrections
Si un lien est mort ou dit autre chose que ce que nous affirmons, écrivez à contact@gohammer.mobi. Voir aussi la Politique éditoriale.
La liste
La liste complète des sources s’affiche sous ce texte, avec l’éditeur et le lien de chacune.