laguinho-api icon indicating copy to clipboard operation
laguinho-api copied to clipboard

Adicionar documentação das rotas do Laguinho

Open lucasmedeiros opened this issue 5 years ago • 4 comments

É necessário adicionar documentação das rotas disponibilizadas pela API (código da branch development, para mais informações consulte a issue de reformulação do laguinho), seguindo o PEP8. No momento, as rotas que temos são:

  • GET /datasets: rota para recuperar todos os conjuntos de dados publicados.
  • POST /datasets: rota para cadastrar/publicar um novo conjunto de dados de um repositório no Github.
  • GET /datasets/nome_dataset: rota que recupera informações (metadados) de um conjunto de dados publicado a partir de seu nome.

lucasmedeiros avatar Oct 01 '19 02:10 lucasmedeiros

Olá, gotaria de ajudar. Posso pegar essa issue? Também gostaria de participar da discussão, haha :smile:

ItaloSa avatar Oct 03 '19 12:10 ItaloSa

@ItaloSa Claro! :smile:

Qualquer dúvida/sugestão que tiver, pode falar comigo por essa issue. Vou te dar assign, ok?

lucasmedeiros avatar Oct 03 '19 12:10 lucasmedeiros

Olá @ItaloSa, se estiver precisando de ajuda ou estiver com dúvidas só falar! Costumamos discutir pelo discord, entra lá :wink:

paulojbleitao avatar Oct 26 '19 03:10 paulojbleitao

Acho que ficou meio em aberto também como a gente pensava em fazer a documentação, mas é mais porque estamos abertos a sugestões também. Na antiga versão do laguinho, a gente tava colocando tudo nums readme mesmo :thinking: mas a gente poderia pensar em algo mais bonitinho também, como o https://docusaurus.io ou um https://swagger.io/ da vida :thinking: o que acham?

JoseRenan avatar Oct 26 '19 03:10 JoseRenan