Pitch: Planio.io - Ferramenta de Suporte a criação de API e base de conhecimento (documentos)
Fala pessoa!
Sou desenvolvor e nos últimos anos tenho trabalhado muito com desenvolvimento de API, e percebi alguns problemas recorrentes em times de dev. Por isso criei o www.planio.io pra auxiliar times no processo de desenvolvimento de software/api.
O projeto está e OPEN BETA, assim que ficaria muito grato se pudessem testar e reportar qualquer sugestao ou erro que encontre.
Vamos lá, abaixo listo as dores que me levaram a criar o www.planio.io
As dores foram:
- Dificilmente no onboarding de un novo membro se conta toda historia, ou por falta de tempo ou por falta de conhecimento geral. Assim leva tempo pro desenvolvedor entender todo o contexto.
- Embora exista un Swagger, uma representacao visual com a interacção de cada API com otros nao existe e o desenvolvedor muitas vezes tem que aprender na prática.
- Uso de muitas ferramentas diferentes (excel, docs, lucid-chart) fazendo com que muitas vezes nao tenhamos disponivel e controlado a ultima versao.
- levamos muito tempo gerando documentação (wiki) onde escrever a primeira versao é geralmente o mais dificil.
Solução:
- Um diagrama VIVO contendo todos os interelacionamentos, ademas d payload/response que se espera.
- Uma plataforma que centraliza (documento texto, planilha, diagramas, wiki) em um so lugar, com processo de compatilhamento de documentos entre times (todos tem a mesma versao e sao notificados de atualizações)
- Uma ferramenta onde eu importo os documentos que tenho acesso e posso a partir deles genarar através de IA um texto que necessito. Por exemplo, liste os requisitos nao funcionais encontrados nos documentos informados. Assim sería muito mais facil e investiríamos menos tempo com documentação.
O video já está desatualizado, preciso criar um novo com as novas funcionalidades que foram incluídas recentemente.