02/11/2006

[RAILS] doc

ATTENTION! Ce post commence par un triste constat, mais il ne faut pas s'arrêter là : Ruby on Rails ça déchire tout, lisez la fin aussi !

 

Malheureusement, à mon niveau [1] Rails a un sérieux désavantage : le manque de docs. Malgré mes deux liens préférés, la ref de Ruby et l'API de Rails, on trouve quand même une information très fragmentée sur Rails, et la plupart du temps, il faut la débusquer dans des blogs. Heureusement, Google est là pour chercher à ma place.

En fait, le vrai problème, c'est que je connais beaucoup, mais pas tout. L'API de Rails contient énormément de choses qu'on ne peut acquérir que par la pratique. Parce qu'au final, quand tu as un truc chiant, répétitif, ou un problème basique que tout le monde s'est déjà posé, la solution existe déjà, mais il faut savoir la chercher. 

 

Que ce soit sur #rubyonrails ou railsfrance.org, la plupart des posts sont d'un niveau assez basique. Ca se résume en trois catégories :
- les énervants : "bonjour, j'ai 14 ans et je ne sais pas lire un message d'erreur",
- les malheureux : "bonjour, j'ai fait un truc super compliqué parce que je ne sais pas que ça existait déjà, ça ne marche pas et je ne sais pas expliquer mon problème"
- et les hardcores.

Moi, je suis à mi-chemin entre un hardcore et un malheureux. Et c'est frustrant.

 

Mais je vous ai promis une happy end, non ? Et bien finalement, vous en aurez trois ! Si vous vous dites parfois que vous faites un truc hyper compliqué alors que ça devrait être simple, rappelez-vous, il y a déjà la solution !

 ...

Et puis non, ca prend trop de place à mon goût. La suite au prochain épisode :) 

 

[1] je dis ca sans me vanter, la plupart des gens un peu sérieux et pas trop cons ayant fait les mêmes études que moi seraient dans le même cas.