Aller au contenu

Doc / Pourquoi c'est fait ainsi

Pourquoi c'est fait ainsi.

Une partie de ce que fait Ignia est contre-intuitive, et volontairement. L'app vous pose des questions au lieu de réexpliquer. Elle attend avant de vous remettre quelque chose sous les yeux, puis le fait au moment où vous étiez sur le point de le perdre. Elle refuse de vous annoncer que vous maîtrisez quoi que ce soit.

Rien de tout cela n'est un choix de style. Chacun répond à un obstacle précis, et chaque page de cette section est construite pareil : voici ce que vous voulez, voici la manière évidente d'y arriver, voici pourquoi elle casse, et ensuite le mécanisme que nous employons à la place.

Comment lire cette section.

  • Chaque principe vient avec sa limite. Une page d'ici ne s'arrête pas au mécanisme. Elle finit sur ce que le mécanisme n'achète pas, parce qu'une affirmation sans limite énoncée est une affirmation que vous n'avez aucun moyen de vérifier.
  • Quand un nombre est une convention, on le dit. Tous les choix de l'app ne sont pas imposés par les données. Certains sont de la calibration, certains sont hérités, certains sont simplement une ligne raisonnable tracée quelque part. Ceux-là sont signalés comme tels plutôt que déguisés en résultats.
  • Les affirmations sur la recherche pointent vers l'article. Chaque page se termine par ses sources, avec une ligne disant ce que chacune y fait — y compris celles qui vont contre nous, et celle dont le chiffre célèbre est justement celui que nous n'appliquons pas. Ce que vous n'y trouverez pas, c'est une taille d'effet imprimée sur la page : une moyenne entre études ne prédit pas votre résultat, et un chiffre sans ses conditions se lit comme plus précis qu'il n'est. Ils sont dans les articles, avec leurs conditions.
  • Les affirmations sur l'app pointent vers le code. Quand une page décrit ce que fait le moteur, elle nomme la fonction ou la constante pour que vous puissiez aller les lire. La section technique documente les mêmes mécanismes au niveau du source, y compris ce qui n'est pas terminé.