Salut, Moi j'ai choisi une solution simple, génération de la doc à partir d'un fichier de définition des différents ressources, j'ai créé un Gem pour ça https://github.com/malachheb/calamum
Le Défaut de cette solution c'est qu'il faut mettre à jour le fichier de définition et régénérer la doc à chaque modification de l'api, c'est pas top comme solution mais ça permet d'éviter les problèmes de génération automatique. Cdt, Mehrez Alachheb. On Mar 4, 2014, at 11:01 AM, Michael Baudino wrote: > Salut Florian, > > J'ai vu passé Apiary sur Twitter il y a quelques temps mais je n'ai jamais > testé : http://apiary.io > Je suis preneur de feedback, ça avait l'air intéressant, même si l'approche > est différente de apipie puisqu'en mode SaaS (mais ça fait plus que juste la > doc). > > > 2014-03-04 9:56 GMT+01:00 Florian Dutey <fdu...@gmail.com>: > Salut a tous. > > Y'en a-t-il parmis vous qui maintiennent des documentations "poussees" pour > leurs API? Si oui, quels outils utilisez vous pour ca? > > Nous avons choisi apipie mais il y a beaucoup de lacunes (un exemple simple, > plusieurs controllers avec le meme nom dans differents namespaces sont > consideres comme un seul et meme controller) et nous avons entrepris quelques > patchs mais ce n'est pas satisfaisant. > > Quels conseils pourriez vous donner svp? > Cdlt. > > -- > -- > 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 > railsfrance@googlegroups.com > Pour résilier votre abonnement envoyez un e-mail à l'adresse > railsfrance-unsubscr...@googlegroups.com > --- > Vous recevez ce message, car vous êtes abonné au groupe Google Groupes > "Railsfrance". > Pour vous désabonner de ce groupe et ne plus en recevoir les messages, > envoyez un e-mail à l'adresse railsfrance+unsubscr...@googlegroups.com. > Pour obtenir davantage d'options, consultez la page > https://groups.google.com/groups/opt_out. > > > > -- > Michael Baudino > @michaelbaudino > +33 (0) 7.61.90.93.62 > Alpine Lab > 1 rue de la Martinière > 69001 Lyon > > -- > -- > 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 > railsfrance@googlegroups.com > Pour résilier votre abonnement envoyez un e-mail à l'adresse > railsfrance-unsubscr...@googlegroups.com > --- > Vous recevez ce message, car vous êtes abonné au groupe Google Groupes > "Railsfrance". > Pour vous désabonner de ce groupe et ne plus en recevoir les messages, > envoyez un e-mail à l'adresse railsfrance+unsubscr...@googlegroups.com. > Pour obtenir davantage d'options, consultez la page > https://groups.google.com/groups/opt_out. -- -- 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 railsfrance@googlegroups.com Pour résilier votre abonnement envoyez un e-mail à l'adresse railsfrance-unsubscr...@googlegroups.com --- Vous recevez ce message, car vous êtes abonné au groupe Google Groupes Railsfrance. Pour vous désabonner de ce groupe et ne plus recevoir d'e-mails le concernant, envoyez un e-mail à l'adresse railsfrance+unsubscr...@googlegroups.com. Pour plus d'options, visitez le site https://groups.google.com/groups/opt_out .