Merci merci, je vais prendre le temps de lire tout ca en details et de trancher avec la team. =)
Le 5 mars 2014 13:28, Jean-Baptiste Barth <jeanbaptiste.ba...@gmail.com> a écrit : > 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 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 .
