Bonjour
comment trouvez vous la documentation sur www.php.net ?
Je la trouve inférieure à la moyenne et vous ?
Bonjour
comment trouvez vous la documentation sur www.php.net ?
Je la trouve inférieure à la moyenne et vous ?
Personnellement je l'aime bien.
Les fonctions sont regroupées par thême, les exemples sont pragmatiques.
Certains articles sont un peu fouillis.
personnellement, je la trouve excellente :
- comme l'a dit sabotage, elles sont regroupees par themes
en plus :
- il y a l'utilisation type de la fonction
- il y a un petit resume pour la fonction
- il y a un exemple d'utilisation
- il y a un message d'avertissement si la fonction n'existe plus d'une version de php a l'autre (ou si elle pose probleme)
- il y a des avis
- il y a des suggestion de fonction qui ont un lien avec la fonction que l'on regarde
("voir aussi :
tel fonction
tel fonction...")
=> pratique si l'on ne connaissait pas une des autre fonctions suggere
- constamment mis a jour (cf les messages d'avertissements d'une version de php a l'autre)
voila, je crois que j'ai fais le tour.
pour moi c'est THE reference si l'on a le moindre probleme avec une fonction![]()
La forme des pyramides prouve que l'Homme a toujours tendance a en faire de moins en moins.
Venez discuter sur le Chat de Développez !
Bonjour
Je trouve aussi que c'est vraiment une très bonne documentation.
Plein de façon d'accéder aux infos, mais des façons assès simple, du coups on s'y perd pas.
D'autre part, quand l'exemple est pas suffisant pour comprendre, il existe beaucoup de commentaire de personne tiers qui comble le vide.
Une fonction par url est sympa avec ensuite la redirection selon la langue est super pratique, mais pas unique à PHP certe
Sky
Pour avoir du utiliser la doc JAVA et la msdn , je reste attaché à la doc php (peut être car c'est avec elle que j'ai commencé).
- La mise en page , ca n'a l'air de rien comme ça , mais ne pas se retrouver sur une simple page blanche sortie des années 90 ca aide énormément à la compréhension.
Exemple : http://java.sun.com/j2se/1.4.2/docs/...ollection.html
- Le moteur de recherche , juste parfait à mon gout
- Les commentaires , qui sont réellement une source d'information extraordinaire. 9/10 on règle un problème en les lisant.
Seul bémol , le nombre de fonction non documenté qui reste significatif.
Je suis du même avis que grunk, je trouve la doc beaucoup plus ouverte (avec les commentaires, exemples, etc.) que celles d'autres plateformes (la doc java par exemple).
Le seul grand soucis reste sur les fonctions/notions mal ou non documentés.
Partager