Re: [Dolibarr-dev] Wiki - demande de précisions

[Yannick Warnier]

Le mercredi 24 mai 2006 à 21:17 +0200, Rodolphe Quiedeville a écrit :
> Le 24.05.2006 16:59, Yannick Warnier a ecrit :
> > Salut,
> > 
> > Pour les demandes de précisions sur la doc du wiki (je peux changer le
> > wiki moi-même si quelqu'un me donne les précisions) je dois m'adresser
> > ici?
> > 
> > Dans la doc pour développeurs, Langages et normes, la section "Syntaxe
> > SQL" est trop brève. Elle ne donne aucun exemple. Dire "Les SELECT *
> > sont interdits" ne dit pas ce qui est permis. De même, "quoter les
> > numériques" ne précise rien sur la façon de faire. Un exemple pour
> > chasue serait parfait.
> > 
> > J'imagine que pas de SELECT * veut dire:
> > SELECT field_a, field_b, field_c FROM ...
> > 
> > et que quoter les numériques veut dire qu'on fait:
> > 
> > INSERT INTO table_1 (field_text, field_num) VALUES ('abcd','1234');
> 
> Tout a fait, tu peux préciser le wiki si tu veux, mais la compréhension
> me semble un préréquis de base pour tout codeur non ?

Non, je ne pense pas de même. Une documentation bien faite permet au
logiciel d'aller beaucoup plus loin (PHP en est un bon exemple).
Beaucoup de petites erreurs (de développeurs) peuvent être évitées avec
une documentation précise, et la documentation par exemples est la
meilleure documentation qui soit.
Ici, en plus, il s'agit de lignes de conduite, donc plus c'est précis,
moins il y a de travail de correction.

Yannick