Bonjour, Je parcours depuis quelque temps déjà la documentation disponible au sujet de Rails et dés le début j'ai été frappé par l'absence de documentation en français, ainsi que par la multiplicité des blogs de développeurs donnant des "bouts" de documentation.
L'exemple le plus frappant c'est lorsque j'ai voulu mettre à jour un site ror 2.5 en ror 3.0. L'outil d'aide (le plugin rails_upgrade) fourni bien la liste de toutes les choses à corriger/faire évoluer, mais les liens vers la documentation sont éclaté sur une dizaines de blogs différents. Par exemple : New file needed : config/application.rb. You need to add a config/application.rb. More information : <http://omgbloglol.com/post/353978923/the-path-to-rails-3-approaching-the-upgrade> Deprecated test_help path: You now must require ‘rails/test_help’ not just ‘test_help’. More information : <http://weblog.rubyonrails.org/2009/9/1/gem-packaging-best-practices> etc ... De mon point de vu de débutant, j'ai trouvé cela vraiment pas pratique, limite rébarbatif, et je me suis demandé pourquoi diable la documentation n'avait pas été regroupé sur une même page ? Il y avait bien la page suivante : <http://edgeguides.rubyonrails.org/3_0_release_notes.html>, mais pareil, les détails sont dispersés un peu partout sur la toile. Au final, D'un côté, ça a été une galère, de l'autre j'ai découvert plein de blogs de développeur très intéressant. Pour en revenir au site railsfrance : (Je m'excuse d'avance, c'est pas juste pour critiquer, c'est surtout pour transmettre le sentiment que j'ai aujourd'hui) La documentation présenté est en fait un forum ou ce mêle question/réponse, traduction, et discussions datant d'un an ou plus, bref ça n'a pas grand chose à voir avec une documentation (attention, pas taper). Et même constat que pour les sites en anglais : la majorité des posts renvoient vers des blogs, sans doute très intéressant à lire, mais la dispersion des liens fait qu'il faut vraiment s'accrocher. Le truc c'est que lorsque je me suis mis en quête de doc en français, le tout premier site de référence que me sort google c'est railsfrance. Et que, mis à part cette mailling-list, j'ai ai pas trouvé grand chose d'intéressant. * La page "liens web" est vide. Y'a bien les catégorie, mais elles sont toutes à zéro. * Le forum n'a pas beaucoup de visite, donc pas de post récent, et donc donne des réponses qui peuvent être dépréciées aujourd'hui * La documentation n'en est pas vraiment une. * Les contributions semblent dater de 2005-2006 * Les offres d'emploi c'est bien ... mais pas pour les débutants :) N'y aurait-il pas un effort à fournir (surtout avec la sortie il y a déjà quelques mois de rails 3) pour regrouper / mettre à jour/ et donner plus de visibilité à la documentation en français ? Ce serait peut-être bien de commencer par un truc simple comme mettre à jour la page "liens" (qui pour le moment n'en fourni aucun) Ps : Je précise que je suis volontaire pour participer à un travail dans se sens. PPs : Je persévère malgré tout, au point d'avoir quasiment terminé mon premier site ror :) -- Vous avez reçu ce message, car vous êtes abonné au groupe "Railsfrance" de Google Groups. Pour transmettre des messages à ce groupe, envoyez un e-mail à l'adresse [email protected] Pour résilier votre abonnement envoyez un e-mail à l'adresse [email protected]
