Publié le | Prend environ 5 minutes à lire
Hier, nous avons enfin publié un projet tant attendu chez Codrops : le nouveau projet de Codrops Référence CSS, rédigé par votre serviteur. Même si j’ai écrit un article sur Codrops présentant la référence et ses fonctionnalités, je souhaite partager un peu plus mon expérience en l’écrivant.
Veuillez noter que depuis janvier 2016, je ne suis plus le mainteneur de la référence CSS Codrops.
Ainsi, contrairement à mes articles de blog hautement techniques habituels, il s’agit d’un article (peut-être ennuyeux, mais court !) partageant un peu plus sur la référence CSS et comment elle est née, et répondant à quelques questions que j’ai reçues via Twitter depuis La version.
Comment tout a commencé
J’ai commencé à écrire pour Codrops en 2013. Quelque temps à la fin de l’année, je me disais : « Codrops serait une référence CSS ultime s’il avait une référence CSS » (sans jeu de mots). J’ai pensé que ce serait fantastique si nous avions une référence CSS à portée de main lorsque quelqu’un a besoin d’en savoir plus sur une propriété CSS spécifique utilisée dans l’une des nombreuses démos créatives qui s’y trouvent. Cette idée m’est venue à l’esprit depuis que j’avais l’habitude de chercher sur Google certaines des propriétés que j’ai vues dans les démos Codrops lorsque j’ai commencé à apprendre CSS et à vérifier Codrops régulièrement.
À peu près à la même époque cette année-là, Manoela m’a approché avec la même idée. C’était une idée dans ma tête et une partie d’une vision que Manoela et Pedro ont pour Codrops. Ce n’est que quelques jours plus tard que j’ai commencé à creuser dans les spécifications CSS et à écrire les entrées de référence.
Il a fallu environ 7 à 8 mois pour terminer toutes les entrées. Pendant ce temps, j’avais peu de temps pour des projets parallèles, mais j’ai continué à écrire – bien que sporadiquement – sur mon blog et d’autres blogs tels que A List Apart, entre autres.
Écrire les entrées de référence
L’une des principales raisons pour lesquelles j’avais hâte de commencer le voyage d’écriture de la référence était de savoir combien j’apprendrais au cours du processus. Pour moi, c’était une raison suffisante pour dire oui instantanément lorsque Manoela m’a approché avec l’idée.
L’une des principales raisons pour lesquelles j’avais hâte de commencer le voyage d’écriture de la référence était de savoir combien j’apprendrais au cours du processus.
Je savais que c’était une chance pour moi d’en savoir beaucoup plus sur CSS que je n’en saurais autrement en si peu de temps. Afin d’écrire la description et les informations sur une fonctionnalité CSS spécifique, j’ai dû creuser plus profondément que d’habitude dans la spécification où cette fonctionnalité CSS est définie.
Comme beaucoup d’entre vous le savent peut-être, les spécifications ne toujours contiennent tout ce que vous devez savoir sur une propriété, et le style d’écriture n’est pas toujours le plus clair (ce qui est l’une des raisons pour lesquelles nous avons également écrit la référence !), j’ai donc dû faire beaucoup de recherches pour de nombreuses entrées, lire d’excellentes ressources ici et là, acquérir beaucoup de connaissances et obtenir beaucoup de moments “ah-ha” dans le processus. Il y avait beaucoup sur CSS que je ne connaissais pas, et que je toujours ne sais pas.
J’ai écrit les entrées CSS de la même manière et dans le même style que j’écris habituellement mes articles. Maintenant, certaines entrées sont des exceptions car elles ne nécessitent pas beaucoup d’élaboration. Par exemple, des propriétés comme border-color sont explicites, donc le ton de ces entrées est plus “officiel” et moins “moi”.
Donc, si vous appréciez mon style d’écriture, je peux dire que vous apprécierez également la lecture des entrées de référence.
Manoela et Pedro m’ont donné beaucoup de liberté et de flexibilité pour écrire la référence à mon rythme, selon mon emploi du temps et mon temps, en veillant à ce que j’aie encore le temps de travailler sur d’autres choses afin que l’écriture de la référence ne limite pas ma créativité. , mon autre travail client, mon blog et, bien sûr, ma vie !
Libération de la référence
Je ne peux même pas commencer à décrire à quel point j’étais excité d’en arriver enfin au point de publier la référence ! Je deviens généralement super nerveux (lire : j’ai presque une crise cardiaque) avant de publier un article de blog sur mon propre blog discret, donc publier plus de 300 les articles courts à longs sur Codrops étaient extrêmement écrasants et angoissants. Je peux toujours entendre mon cœur battre quand je tweete à propos d’un nouveau billet de blog, et je l’ai certainement fait quand nous avons enfin fait connaître la référence.
Il nous a fallu un peu plus d’un an pour publier la référence en raison de la quantité de travail que chacun de nous à Codrops avait, en plus de la référence. 2014 a été l’année où j’ai commencé à parler lors de conférences, et dans la seconde moitié de celle-ci (c’est-à-dire après avoir fini d’écrire les entrées), j’ai eu les mains pleines de travail de conférence, d’écriture et d’autres choses qui ont détourné mon attention de la référence pour certains temps. Mais nous y sommes finalement parvenus.
Des questions
J’ai reçu quelques questions d’abonnés et de commentateurs, et deux de ces questions revenaient sans cesse.
Est-ce « le nouveau MDN » ?
Non ce n’est pas. Au moins, ce n’était pas notre but de faire en sorte qu’il en soit ainsi. Ce n’est même pas conçu comme une concurrence à toute autre référence CSS. Il s’agit simplement d’une autre base de connaissances qui s’ajoute à ce que Codrops propose déjà régulièrement.
J’écris beaucoup sur CSS (et SVG), que ce soit sur mon blog, sur Codrops ou sur l’un des nombreux autres endroits où j’écris. La référence CSS est, pour moi, simplement une archive où j’ai collecté articles de blog sur un sujet spécifique (CSS, dans ce cas), et les a organisés de manière à ce qu’ils soient plus faciles à parcourir et plus simples pour que mes lecteurs trouvent ce qu’ils recherchent.
La référence CSS est, pour moi, simplement une archive où j’ai collecté articles de blog sur un sujet spécifique (CSS, dans ce cas), et les a organisés de manière à ce qu’ils soient plus faciles à parcourir et plus simples pour que mes lecteurs trouvent ce qu’ils recherchent.
J’y pense même parfois comme un livre ! Au lieu d’écrire un livre CSS imprimé, j’ai écrit un livre en ligne, ouvert à vos contributions et suggestions via un dépôt Github que nous avons partagé sur Codrops. Il a donc un avantage sur un livre ordinaire en ce que vous, mes chers lecteurs, pouvez identifier les erreurs, les erreurs, demander des ajouts et des suggestions, etc.
Pourquoi n’avez-vous pas plutôt contribué à MDN ?
Honnêtement, je ne comprends pas le raisonnement derrière cette question. Je veux dire, pourquoi devrais-je pas écrivez la référence et choisissez de contribuer à MDN plutôt?
Cela étant dit, j’ai mentionné plus tôt quelques raisons pour lesquelles j’ai choisi d’écrire la référence. Ajoutez à ceux que j’aime Codrops, et Manoela et Pedro m’ont donné beaucoup de liberté et de flexibilité pour donner à la référence son propre caractère et son propre style. Ils m’ont demandé de l’écrire parce que ils ont aimé mon style d’écriture et m’ont donc donné la liberté de structurer les entrées comme je le voulais. Nous avions quelques spécificités – par exemple, les sections pour la syntaxe officielle, la prise en charge du navigateur, etc. que nous devions avoir dans chaque entrée, et le reste était à moi d’écrire à ma manière.
Maintenant, je ne sais pas si MDN m’aurait permis de faire la même chose, mais Manoela sait à quel point j’apprécie la liberté et la flexibilité du travail dans mon travail, et elle m’a donné exactement cela, rendant l’expérience beaucoup plus agréable, et se sentir beaucoup moins comme une tâche ou un travail.
Derniers mots
Écrire la référence CSS a été une expérience merveilleuse, et je suis heureux d’avoir eu la chance de le faire. Je sais que je n’ai pas littéralement écrit un livre ici (comme dans : un imprimé livre), mais j’aime à penser que j’ai – peut-être parce que cela me fait sentir un un peu moins coupable de ne pas avoir encore commencé à écrire mon livre SVG !
J’espère de tout cœur que vous l’aimerez, que vous le trouverez utile et que vous en apprendrez autant que j’ai appris en l’écrivant. Vos retours sur Twitter, dans les commentaires et vos contributions dans le référentiel Github ont été incroyables – merci beaucoup pour votre soutien !
Et merci d’avoir lu ce message, et lire les entrées de référence à l’avenir.
–S