JoYz.Pro Dev: ReadMe "Old School"
Résumé : Une approche simple, structurée et volontairement minimaliste pour documenter et présenter du code web, inspirée d’une vision “old school” du développement.
Une approche assumée
Je fais partie de ceux qui ont appris le web avec une approche directe, sans couches inutiles, avec une compréhension fine du HTML, du CSS et du PHP avant tout.
Mon approche est volontairement old school : privilégier la lisibilité, la stabilité et le contrôle total du rendu plutôt que l’empilement de frameworks ou d’abstractions.
Le rôle du JavaScript
Pendant longtemps, j’ai volontairement limité l’usage du JavaScript dans mes pages, principalement pour des raisons de sécurité et de robustesse.
Cela ne signifie pas pour autant l’abandon du JS : je l’utilise lorsque c’est pertinent, notamment pour enrichir le DOM avec des effets visuels ou des interactions ciblées.
Le principe reste simple : le JavaScript doit rester un ajout, pas une dépendance.
Le concept 4Strict & 5Royals
Dans cette logique de simplification, j’ai défini une structure de base que j’utilise dans mes projets : 4Strict & 5Royals.
Le contrat est volontairement minimal :
- 4 balises HTML strictes pour structurer la page :
- <header>
- <nav> (menu)
- <main> (contenu)
- <footer>
- + 1 balise <section> pour organiser le contenu interne
Rien de plus. Pas de surcouche. Pas de complexité inutile.
Cette approche permet :
- une lecture immédiate du DOM
- une maintenance simplifiée
- une cohérence structurelle sur tous les projets
Simple… et efficace.
Documentation complète : Voir le README 4Strict & 5Royals
Le format README “Old School”
Dans la continuité de cette philosophie, j’ai commencé à publier des documents README directement en HTML.
L’objectif est simple :
- expliquer un concept ou un composant
- montrer du code clair et isolé
- fournir une démonstration directe
Pas de documentation lourde, pas de dépendance externe : juste une page lisible, autonome et exploitable immédiatement.
ReadMe disponibles
Plusieurs README sont déjà disponibles et couvrent différents aspects de mes expérimentations frontend :
- Effets CSS (inset shadow, cartes, UI)
- Structures HTML strictes
- Comportements JS ciblés
Accès direct : Voir la collection de README
Conclusion
Cette approche ne cherche pas à suivre les tendances, mais à rester maîtrisable, durable et compréhensible.
Le web n’a pas besoin d’être complexe pour être efficace.
Parfois, revenir à des bases simples est ce qui permet d’aller le plus loin.