Re: et pourquoi...

Peut être que l'exemple de Qt n'était pas le meilleur, mais il existe forcément plein de bibliothèques qui ne sont pas documentées. L'intérêt de Polydoc est qu'à terme il faudrait qu'il y ait un maximum de bibliothèques, tout étant centralisé. On pourrait dans une page de Qt parler de GTK, et en voir dans GTK, la présentation serait la même que pour Qt. Ce serait expliqué de la même manière.

Autre exemple, sur Polydoc on compte documenter par exemple l'OCaml. Je ne sais pas s'il existe une doc en ligne français ou pas, mais imaginons que lorsqu'on explique un concept propre à OCaml, on parle de l'équivalence à Haskell ou Ruby. On suivrait le lien, et sans changer de site, ni de structure, ni rien du tout, on pourrait voir la correspondance avec l'autre langage.

Dans la doc PHP, par exemple, si tu trouve une erreur, pour la rectifier il faut envoyer un mail à un admin, pour qu'il édite en circonstance, etc. C'est pas pratique. Les exemples, l'interface et les commentaires sont en anglais, aussi. L'ergonomie est plus que perfectible, encore plus lorsqu'on est débutant, je trouve (par exemple, si on cherche une fonction sur la manipulation des chaînes de caractères, mais qu'on ne connait pas son nom, on est obligé de toutes les lire une par une pour voir si c'est celle désirée, encore faut-il avoir trouvé la catégorie "Strings" - pas évidente pour un nouveau).

[ Répondre ]