Salut, C'est vrai que les docs en français sont assez rares, mais si ça t'intéresse un effort à été débuté en ce sens, je te conseil ce thread : http://groups.google.com/group/railsfrance/browse_thread/thread/ccd6c264146a88ce/0b2e8121a37fc2ba?lnk=gst&q=traduction# La traduction de la docrails en français est un début assez long, mais c'est el début le plus logique je pense ;) (https://github.com/ gdurelle/docrails)
En ce qui concerne plus particulièrement le passage d'un site de 2.5 en 3, je pense que c'est simplement compliqué, même si l'excellent livre de Jeremy McAnally permet de faire ça "facilement" avec son plugin en prime, il y a eu tellement de changements entre les 2 versions que c'est forcement épuisant ;). Le mieux je pense c'est de repartir de 0 si le projet n'est pas trop gros. On 17 déc, 09:59, Kévin Polez <[email protected]> wrote: > 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-...> > > 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]
