Facebook LinkedIn SourceForge Twitter RSS LastFM
logologo

Ma premire contribution au manuel PHP

Geoffray Warnants|24/05/2011|38 commentaires

Au cours de mes recherches dans les profondeurs de la documentation PHP, il m'arrive assez fréquemment de rencontrer des anomalies diverses comme des prototypes de fonction incomplets, de grossières fautes d'orthographe ou des phrases à peine plus compréhensibles que celles générées par un traducteur automatique. Autant de détails dont l'importance peut paraître insignifiante mais qui contribuent à décrédibiliser le sérieux du langage. Et pourtant, en ingrat développeur que je suis, j'avoue n'avoir jamais pris la peine d'informer la communauté PHP de ces défauts, sombrant de jours en jours en peu plus loin dans le péché.

Jusqu'au jour où ma bonne conscience se réveilla, probablement illuminée par une intervention de notre bienveillant Dieu Rasmus, qui de tout là-haut ramène ses fidèles développeurs dans le droit chemin. Au cours de cette divine apparition, il me pardonna puis me rappela l'existence de son outil de rapport de bugs et insista sur le fait que les problèmes liés à la documentation y sont bien entendu acceptés, car tout bug est égal à son prochain.

Je me suis donc depuis lors acharné à signaler le moindre problème rencontré, et c'est ainsi plus d'une centaine de corrections qui ont été envoyées, approuvées puis appliquées à notre manuel chéri. Sans vouloir imiter Frédéric Hardy et ses Nouvelles du front, voici l'inventaire des modifications apportées aux prototypes de nombreuses fonctions :

#54747, #54748, #54749, #54750, #54751, #54752, #54753, #54754, #54755, #54756, #54757, #54761, #54762, #54763, #54768, #54770, #54771, #54772, #54773, #54779, #54780, #54781, #54782, #54783, #54784, #54785, #54786, #54787, #54788, #54789, #54790, #54793, #54794, #54795, #54796, #54797, #54800

Celles-ci, plus anecdotiques, concernent essentiellement des corrections orthographiques dans la documentation francophone et des erreurs relevées dans les scripts d'exemple.

#54806, #54807, #54808, #54809, #54810, #54811, #54812, #54813, #54814, #54815, #54816, #54817, #54818, #54819, #54820, #54822, #54823, #54825, #54826, #54827, #54828, #54829, #54830, #54833, #54834, #54835, #54836, #54837, #54838, #54839, #54840, #54841, #54845, #54846, #54847, #54848, #54849, #54850, #54853, #54854, #54855, #54856, #54857, #54858, #54868, #54869, #54872, #54873, #54874, #54875, #54876, #54877, #54878, #54879, #54880, #54881, #54882, #54883, #54884, #54885, #54886, #54887, #54889, #54890, #54891

Une démarche apparemment trop peu fréquente, puisqu'elle a suscité la curiosité de plusieurs membres éminents de la Documentation Team comme Peter Cowburn, Richard Quadling ou Pierrick Charron, visiblement soucieux de mon intégrité humaine. La méthode utilisée ne relève pourtant pas du miracle : j'ai simplement téléchargé le manuel au format HTML, puis à l'aide de quelques expressions régulières j'ai rapidement pu détecter les fautes d'orthographe ou de grammaire courantes. Je ne peux donc qu'encourager chaque développeur à participer, dès qu'il en a l'opportunité, à l'amélioration de ce formidable outil dont nous profitons tous égoïstement. Un simple acte citoyen suffit à témoigner de la reconnaissance envers les nombreux anonymes bénévoles dont les contributions nous furent, un jour ou l'autre, d'une aide plus que précieuse.

<<< Retour

Vos commentaires

17 commentaires postés

Michel Billon
17/04/2022 21:50Posté par Michel Billon
Bonjour Geoffray,

Travaillez vous freelance? J'ai des missions (100% remote et sans horaire fix) pour vous en javascript & PHP. vous seriez parfait pour le job.

Bien vous,

Michel
Defrost Meat Faster
16/12/2021 17:37Posté par Defrost Meat Faster
Defrost frozen foods in minutes safely and naturally with our THAW KING?.


50% OFF for the next 24 Hours ONLY + FREE Worldwide Shipping for a
LIMITED

Buy now: thawking.store
Ilyana Vincent
29/12/2020 04:45Posté par Ilyana Vincent
? mon avis, avoir une manuelle de PHP permet de rendre le d?veloppement d?application Web plus rapide et plus efficace. Mais, cela ne veut pas dire que tous les probl?mes sont r?solus, il faut consulter quand m?me les experts.
Andrea Meyer
17/08/2020 23:20Posté par Andrea Meyer
Pour ma part, votre exprience est vraiment trs remarquable. Mais, ce que je n?arrive pas comprendre dans la vie des hommes. Pourquoi ne pas faire appel des experts dans ce genre de situation??
keflex price
11/06/2020 07:26Posté par keflex price
keflex price
buy tylenol
30/04/2020 22:59Posté par buy tylenol
buy tylenol
tadalafil 20mg
09/04/2020 16:07Posté par tadalafil 20mg
tadalafil 20mg
amoxicillin
08/04/2020 19:32Posté par amoxicillin
amoxicillin
llilia9
09/11/2017 13:16Posté par llilia9
J?ai trouve cet article trs intressant.Merci
tudiante
10/06/2017 08:25Posté par tudiante
Cet article est trs intressant et surtout trs enrichissant!
KaRaK
23/04/2013 17:57Posté par KaRaK
La grande classe !
JC
05/11/2012 23:09Posté par JC
Bonsoir,

Merci votre blog est formidable....

Cordialement
Yannick
17/09/2011 11:46Posté par Yannick
... comme, entre autres, l'espagnol et le russe !

Bref. Tout cela pour dire que le dbut du billet est un peu aride, mais que nous apprcions ton travail ;)
Yannick
17/09/2011 11:14Posté par Yannick
Pour rappel, la documentation PHP, c'est plus de 10 000 fichiers XML. La documentation franaise est la traduction la plus a jour parmi toutes celles que compte le manuel. Outre les "fautes d'orthographe grossires", outre les traductions "a peine plus comprhensibles que celles issues Dun traducteur automatique", il y a aussi de simples fautes de frappe effectues par des bnvoles qui passent un temps prcieux a contribuer du mieux possible.

Et pour rappel, l'outil permettant d'editer en ligne la documentation Php est d'origine franaise (cocorico) et a permi un expansion de plusieurs langages ces derniers mois
thedotwriter
01/09/2011 14:09Posté par thedotwriter
C'est beau :')
Continue comme a, si a se trouve une de tes corrections m'a servie dans le pass !

Bravo toi !
warnants olivier
08/06/2011 14:30Posté par warnants olivier
je ne comprend rien a tout sa mais je suis fiere de toi
syndrael
25/05/2011 14:31Posté par syndrael
Flicitation.. c'est bien de s'impliquer comme a.
Pour ma part, j'ai hlas trop peu de temps pour cela mais je le fais pour certains diteurs. Je recommande pour la cration de workflow ProcessMaker. Je suis dans le top 5 des dcouvreurs de bugs..LOL !!
S.

Réagir à cet article

*


(Ne sera pas publiée, servira uniquement à afficher votre gravatar)


(Lien en dur et dofollow)

zend framework