Découvrez les fiches techniques

La recherche du bon format

Depuis l’annonce de la nouvelle version de NX, j’ai été un peu avare en nouveautés. On pourrait croire que j’ai lancé la page d’accueil de la V2 et que j’ai directement abandonné. C’est loin d’être le cas. Mon travail principal m’a demandé pas mal de temps en fin d’année scolaire et je n’ai pas pu avancer autant que je le souhaitais.

Je profite donc de la pause estival pour travailler sur NX et notamment sur la création d’un nouveau format. Pour être honnête, cela fait un moment que j’avais ça en tête. Je voulais un contenu plus court. Il devait être plus rapide à écrire et à lire. Je n’abandonne pas la création de cours, loin de là.

Cela dit, il faut bien comprendre que les cours sont des contenus très denses. Ils demandent beaucoup de temps à réaliser. Il faut penser aux notions que l’on souhaite aborder, au plan, au projet fil rouge, etc. Puis, il y a aussi l’écriture du cours et l’enregistrement des screencasts. Tout cela prend un temps considérable. Avec la V2 de NX, les intégrer à la plateforme reste prioriraire. Cependant, bien les intégrer va demander du temps.

Les fiches techniques sont ce nouveau format. Je me suis inspiré des cheatsheets, quelque chose de bien connu dans le monde anglophone. Traduit litéralement, on les appelle des feuilles de triche. J’aime bien cette idée d’anti-sèche. Cela dit, j’avais envie de les retravailler un peu : je les trouve parfois un peu trop théorique.

Un condensé d’informations accessible et pratique

Alors, qu’est-ce qu’une fiche technique ? Pour faire simple, une fiche technique est en rapport avec une notion unique. Là où un cours regroupe de nombreuses notions, la fiche technique se concentre sur l’essentiel. Par exemple, la propriété CSS Box Sizing.

Elle se veut rapide à écrire et à lire. L’idée n’est pas de passer des semaines à écrire une fiche technique comme c’était le cas avec les cours. Cela dit, elle doit aussi contenir le plus d’informations pratique. Idéalement, j’aimerais qu’une fiche technique vous permette d’intégrer directement un morceau de code, ou une bonne pratique, une fois celle-ci terminée.

Autre point important : une fiche technique doit vous permettre d’aller plus loin facilement. Elle doit contenir des ressources sélectionnées spécifiquement en rapport avec le sujet. Cela peut peut-être sembler normal pour certains mais il faut savoir que beaucoup de développeurs rencontrent des difficultés dans le choix des ressources. Dans un sens, nous faisons ce travail pour vous.

J’ai aussi bon espoir que les fiches vont nous aider côté SEO. Ce n’est pas forcément l’aspect le plus glorieux du web. En effet, quand on pense SEO, on peut souvent à des articles optimisés pour le SEO avec beaucoup de mots clés. Ces articles représentent souvent un interêt limité pour l’utilisateur. J’espère ici faire le contraire. Autrement dit, faire que les fiches techniques soient bien référencéess et contiennent un contenu de qualité.

Une base pour intégrer les futurs cours

La nouvelle version de NX utilise le framework Astro JS. Pour votre information, l’ancienne version passait par un LMS : Teachable. Cet outil m’a permis de développer la première version de NX rapidement sans trop me soucier du code. Un peu comme avec WordPress pour les CMS, je suis passé par une solution clé en main qui s’occupe aussi bien de la partie paiement, gestion des comptes et herbegement des cours et des vidéos.

Cet outil avait néanmoins des inconvénients. Il coutait relativement cher (plus de 1600€ par an) notamment au regard des cinq cours publiés sur la plateforme. Autre problème, il n’y avait pas une intégration “simple” entre les différents contenus. J’avais soit le choix entre les cours, soit des ressources. C’était assez limitant. D’où le fait de passer par la création de notre propre outil.

L’avantage de développer notre propre outil est la liberté de pouvoir lier les différents contenus plus facilement. C’est vraiment quelque chose d’important. Je souhaite pouvoir tester différents formats pédagogiques et faciliter la collaboration. De plus, avec le changement de modèle de NX (un modèle payant par abonnement à un modèle entièrement gratuit et open-source), le choix d’avoir notre propre outil faisaint sens.

Mais là encore, il y a des desavantages. On doit penser tous ces contenus en amont. C’est un travail passionnant mais il y a le risque de partir dans tous les sens. Vous prenez le risque de rendre votre code immaintenable et multiplier les formats. C’est une balance assez difficile à trouver. D’où l’idée de travailler sur des formats plus cours.

En travaillant sur des contenus et des formats plus courts, on peut plus facilement itérer et trouver les bonnes fonctionnalités à développer. On peut tester plus facilement sans prendre le risque de rentrer dans un tunnel. Je recommencerais à réintégrer les cours bientôt mais dans un premier temps, je vais me concentrer sur les fiches techniques. D’autant plus que je ne suis plus seul à coder sur le projet.

Les premières fiches techniques JavaScript / CSS

J’ai donc le plaisir de vous présenter les premières fiches techniques de NX ! Elles sont pour l’instant en lien avec le CSS et le JavaScript. Vous pouvez les consulter sur cette page.

Je vous invite à lire les fiches :

• le this en JavaScript, rédigé par Lionel ;
• la méthode CSS Clamp de moi-même ;

N’hésitez surtout pas à nous faire un retour via GitHub - ce lien vous permettra d’ouvrir une issue sur notre repository GitHub.

Bonne lecture.
Thomas