Document de référence

Charte éditoriale

Intention

Permettre à un débutant d'acquérir le socle nécessaire pour lire, exécuter et vérifier un premier programme avec un agent ; permettre ensuite à un décideur de piloter la fabrication d'un logiciel, puis d'accéder aux mécanismes d'ingénierie qui justifient ses décisions. Le manuel n'est ni une collection de prompts magiques ni une défense d'un fournisseur.

Partie zéro commune

P01 à P05 forment un parcours progressif unique avant les lectures miroirs. Chaque étape part d'une prédiction, fait lire et exécuter un changement, introduit une erreur à diagnostiquer puis se termine par un exercice autonome et un corrigé raisonné. Les encadrés techniques sont facultatifs ; aucun prérequis en programmation n'est supposé.

Deux lectures pour chaque chapitre

La partie I contient A01 à A12 ; la partie II, B01 à B12. Axx et Bxx portent le même sujet, dans le même ordre et avec le même exemple. La première lecture ne réserve pas sa conclusion à la seconde. La seconde rappelle brièvement le problème pour être lisible indépendamment.

AccessibleIngénieure
Comprendre le problème et choisir une action.Expliquer les mécanismes, concevoir et vérifier.
Situations concrètes et mots expliqués au premier usage.Contrats, états, limites, modes de panne et preuves.
Peu de code ; exemples lisibles sans langage particulier.Extraits exécutables lorsque utiles, environnement et version précisés.
Questions à poser et signaux d'alerte.Compromis, tests, contre-exemples et procédures de reprise.
Exercice de décision avec corrigé.Exercice de conception ou de diagnostic avec corrigé.

Ton

Tutoiement clair, précis et non condescendant. Expliquer avant de nommer. Ne pas remplacer une justification par « industriel », « absolu », « souverain » ou « déterministe ». Une métaphore aide à comprendre mais ne constitue pas un théorème.

Modèle de chapitre final

Situation concrète ; objectif ; raisonnement ; exemple du fil rouge ; limites et erreurs fréquentes ; exercice ; corrigé ; checklist ; sources et renvoi miroir. Les amorces livrées sont le point de départ, pas ce format final entièrement rempli.

Règles de preuve

  • Distinguer constat dans les sources, synthèse éditoriale et validation externe.
  • Indiquer chapitre ou section source ; préférer les textes Markdown aux extractions PDF pour les détails.
  • Dater les éléments variables : versions, licences, API, prix, capacités et compatibilité.
  • Une configuration copiée d'une source n'est pas réputée testée.
  • Ne pas promettre sécurité totale, absence de panne ou correction universelle.
  • Les noms de modèles et bibliothèques sont des exemples à vérifier, pas un classement permanent.

Publication

Valider les droits sur les textes fournis et choisir une licence explicitement. Aucune attribution d'auteur ou autorisation de republication n'est déduite du simple dépôt local.