Remarques sur le guide français

brunch / brunch-guide

A comprehensive guide to Brunch

http://brunch.io

MIT License

557 stars 63 forks source link

Remarques sur le guide français #19

Open PhiLhoSoft opened 8 years ago

PhiLhoSoft commented 8 years ago

Quelques remarques notées en lisant le guide français.

UN pipeline. C'est un mot masculin. Vu au féminin dans https://github.com/brunch/brunch-guide/blob/master/content/fr/chapter01-whats-brunch.md
Séparer l'unité de la valeur : 0.5 s, 300 ms, 44 %, etc. Idéalement avec une espace insécable (oui, espace est féminin en typographie... :smile:).

Aparté : bon style d'écriture, un peu familier, mais vivant. Peut-être un peu d'abus du gras, on croirait lire un comic ! :wink:

J'ai téléchargé Growl for Windows, puis growlnotify, avant de m'apercevoir que ce dernier est inclus dans le premier (v.2.0.9 de mars 2012). Pas bien grave (le fichier est petit, la page donne les paramètres) mais peut valoir le coup d'être mentionné.

(À suivre, sauf si la suite est parfaite...)

paulmillr commented 8 years ago

:horse:

PhiLhoSoft commented 8 years ago

Je n'ai pas compris le commentaire... :smile:

Dernière remarque (en date...) : https://github.com/spyl94/eslint-brunch semble apporter un support de ESLint pour Brunch (les docs disent qu'il n'est pas encore supporté). Vu que j'ai commencé à utiliser ESLint, et que je l'apprécie, c'est une des premières choses que je vais essayer avec Brunch !

Ah, si, je trouve qu'il manque quelque chose dans le "premier build" : un test unitaire. À mon humble avis, il serait bon de les introduire dès le début, pour renforcer les bonnes pratiques et montrer comment tester avec Brunch. En fait, je ne me souviens pas d'avoir vu le thème abordé dans cette doc. Pensez-vous le rajouter ?

PhiLhoSoft commented 8 years ago

@paulmillr I am not sure I understood your "remark"... :wink: I wrote the issue in French because it is about the French version of the docs, with minor remarks (the doc is excellent) on typography, syntax and usage. Obviously, these remarks are aimed at the original author of the French doc... :smile: I can do a PR on these docs, if the author has no time to fix them.

paulmillr commented 8 years ago

Yep — please send a pull request!

es128 commented 8 years ago

@PhiLhoSoft I definitely agree on the overuse of bold. If you make adjustments in that regard in a PR, would appreciate if you make matching changes on the English version while you're at it.