<p dir="ltr">No caso de "documentar API" eu tenho uma dificuldade imensa em entender como algo "mais independente" poderia ser "melhor". Ser eu entendo algo sobre o próprio conceito de API é que algo sempre é melhor quanto mais "universal" for, ou seja, usar um padrão deveria ser sempre superior do que qualquer solução adhoc. Se isso não é verdade para a maioria das escolhas de design de software, isso ainda deveria ser verdade para o design de API. O que eu estou sem visualizar?<br>
</p>
<br><div class="gmail_quote"><div dir="ltr">Em sáb, 19 de set de 2015 19:41, Marcelo Milhomem <<a href="mailto:milhomem@is4web.com.br">milhomem@is4web.com.br</a>> escreveu:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div><span style="background-color:rgba(255,255,255,0)">Para documentar APIs eu achei mais interessante o <a href="http://apidocjs.com/" target="_blank">http://apidocjs.com/</a> bem mais independente e tem basicamente os mesmos recursos.</span></div>
<div><span style="background-color:rgba(255,255,255,0)"><br></span></div>
<div><span style="background-color:rgba(255,255,255,0)">[]s</span></div>
<div>
<br><div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.8000001907349px;line-height:normal;background-color:rgb(255,255,255)">
<div><font face="tahoma, sans-serif"><font color="#f1c232">Marcelo Milhomem</font> <font color="#000000">• Software Engineer </font></font></div>
<div><font face="tahoma, sans-serif"> <img src="http://imageshack.com/a/img908/2431/aNmDAh.png">+55 (11) 96943-6961<br></font></div>
<div>
<font face="tahoma, sans-serif"> <img src="http://imageshack.com/a/img537/2766/LuPjhu.png"></font><font color="#000000" face="tahoma, sans-serif">marcelomilhomem</font>
</div>
<div>
<font color="#888888" style="font-family:tahoma,sans-serif"> <img src="http://imageshack.com/a/img841/9329/2rzs.jpg"> </font><font style="font-family:tahoma,sans-serif;color:rgb(17,85,204)"><a href="http://br.linkedin.com/in/marcelomilhomem/" style="color:rgb(17,85,204)" target="_blank">Marcelo F. da C. Milhomem</a></font><b style="font-family:tahoma,sans-serif"><font color="#444444"> </font></b>
</div>
<div><font face="trebuchet ms, sans-serif" color="#000000" style="text-align:-webkit-auto"></font></div>
<div><b style="text-align:-webkit-auto;font-family:tahoma,sans-serif;font-size:large"><font color="#444444">_______________________________ </font></b></div>
<div><span style="text-align:-webkit-auto;font-family:tahoma,sans-serif"><font color="#444444">Number 1 taxi solution for businesses and individuals. Discover the revolution!</font></span></div>
<div><img src="http://imageshack.com/a/img913/6885/2ucylX.png"></div>
</div>
<div style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:12.8000001907349px;line-height:normal;background-color:rgb(255,255,255)"><div style="text-align:-webkit-auto">
<font color="#999999" face="tahoma, sans-serif" size="1"><span style="line-height:24px">Avenida Queiroz Filho 1700 – Torre C <a style="color:rgb(34,34,34)"></a>Sala 402, </span></font><font color="#999999" style="font-family:tahoma,sans-serif;font-size:x-small;text-align:-webkit-auto"><span style="line-height:24px">05319000 </span></font><span style="font-family:tahoma,sans-serif;font-size:x-small;text-align:-webkit-auto;line-height:24px"><font color="#999999">São Paulo, SP, Brazil</font></span>
</div></div>
</div>
<br><br><div class="gmail_quote"></div><div class="gmail_quote"><p>On Sat, Sep 19, 2015 at 2:01 PM, Eduardo Almeida <span dir="ltr"><<a href="mailto:eduardo@web2solutions.com.br" target="_blank">eduardo@web2solutions.com.br</a>></span> wrote:<br></p></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div>
<div>Booooa ... ja tinha visto o post do
Thorsen<br><br>
Em 9/19/15 10:43, Leonardo Ruoso escreveu:<br></div>
<blockquote type="cite">
<div dir="ltr">Além do Raisin [<a href="https://metacpan.org/pod/Raisin" target="_blank">https://metacpan.org/pod/Raisin</a>],
vale a pena também dar uma olhada no [<a href="http://thorsen.pm/perl/programming/2015/07/05/mojolicious-swagger2.html" target="_blank">http://thorsen.pm/perl/programming/2015/07/05/mojolicious-swagger2.html</a>]</div>
<div class="gmail_extra">
<br><div class="gmail_quote">2015-09-19 10:28 GMT-03:00 Leonardo
Ruoso <span dir="ltr"><<a href="mailto:leonardo@ruoso.com" target="_blank">leonardo@ruoso.com</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="ltr">
<div>Dicas para fábricas de software e integradores:</div>
<div><br></div>
<div>Perl helpers para trabalhar com Swagger:</div>
<div><br></div>
<div>
<a href="http://www.perlmonks.org/?node_id=1126733" target="_blank">http://www.perlmonks.org/?node_id=1126733</a><br></div>
<div><br></div>
See: <a href="http://swagger.io" target="_blank">http://swagger.io</a><span><font color="#888888"><br clear="all"><div><br></div>
-- <br><div>Leonardo Ruoso
<div>Journalist, Perl developer and business
consultant<br><div>Media, UFC/2006; Telecom, IFCE/1998</div>
</div>
</div>
</font></span>
</div>
</blockquote>
</div>
<br><br clear="all"><div><br></div>
-- <br><div>Leonardo Ruoso
<div>Journalist, Perl developer and business consultant<br><div>Media, UFC/2006; Telecom, IFCE/1998</div>
</div>
</div>
</div>
<br><fieldset></fieldset><br><pre>=begin disclaimer
Sao Paulo Perl Mongers: <a href="http://sao-paulo.pm.org/" target="_blank">http://sao-paulo.pm.org/</a>
SaoPaulo-pm mailing list: <a href="mailto:SaoPaulo-pm@pm.org" target="_blank">SaoPaulo-pm@pm.org</a>
L<a href="http://mail.pm.org/mailman/listinfo/saopaulo-pm" target="_blank"><http://mail.pm.org/mailman/listinfo/saopaulo-pm></a>
=end disclaimer
</pre>
</blockquote>
<br><br></div></blockquote></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div>-- <br>
Eduardo Almeida - Software Engineer<br><a href="mailto:eduardo@web2solutions.com.br" target="_blank">eduardo@web2solutions.com.br</a> - 27.99831.8663<br><br><b>WEB2 Solutions</b> - Inovando, sempre!
<br></div></div></blockquote></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div><div><dhtmlx_certified.png></div>
</div>
</div></blockquote></div><br>=begin disclaimer<br>
Sao Paulo Perl Mongers: <a href="http://sao-paulo.pm.org/" rel="noreferrer" target="_blank">http://sao-paulo.pm.org/</a><br>
SaoPaulo-pm mailing list: <a href="mailto:SaoPaulo-pm@pm.org" target="_blank">SaoPaulo-pm@pm.org</a><br>
L<<a href="http://mail.pm.org/mailman/listinfo/saopaulo-pm" rel="noreferrer" target="_blank">http://mail.pm.org/mailman/listinfo/saopaulo-pm</a>><br>
=end disclaimer<br>
</blockquote></div>