Swagger & swagger-ui font le genre de choses décrites par Mehrez: http://swagger.wordnik.com/ avec de la génération auto-magique facile si tu utilises grape (github => swagger tu trouveras ton bonheur). Je commence à l'utiliser sur un petit projet et ça marche pas mal, mais je ne sais pas si ça fera ton bonheur selon la complexité de ton API (et je ne sais pas non plus ce que ça donne avec plusieurs namespaces..).
Cheers, Le 4 mars 2014 11:55, Mehrez Alachheb <lachheb.meh...@gmail.com> a écrit : > 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 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 .
