No video
App open-source para documentar APIs (funciona mesmo!)
Descobri vários apps legais enquanto tava navegando por uma galeria de projetos open source, a oss.gallery
Muito do que tinha lá eu já conhecia ou já tinha visto algo parecido, mas encontrei um que se propõe a criar documentações de APIs sem esforço (meu, no caso).
Resolvi testar na hora com uma open API recente e fiquei surpreso com o resultado.
-----
Conecte-se a 500mil devs e avance para o próximo nível com a nossa plataforma: rocketseat.com.br/
Cadastre-se na nossa plataforma: app.rocketseat.com.br/signup
Junte-se a mais de 392mil devs em nossa comunidade no Discord: / discord
Acompanhe a Rocketseat nas redes sociais:
Twitter: @rocketseat
Facebook: @rocketseat
Instagram: @rocketseat
Пікірлер: 33
Diegão tirando aquela foto nossa nos 2:54
"Ele tem a melhor feature: Light Mode" 🤣 Quase choreide rir
Descobri o Scalar quando estava testando Elysia na NLW retrasada. Desde lá, tenho usado ele nos serviços de onde trabalho. Super recomendo.
@SohaaTitanio
2 ай бұрын
O que ele faz exatamente? Pelo que li ele apenas mostra a documentação do swagger de uma forma bonita.
@melkdesousa9302
2 ай бұрын
@@SohaaTitanio Também. Mas ele mantem histórico de chamadas e code snippets de chamadas. Na plataforma dele, permite também fazer uma documentação mais rica, estilo Notion.
Gostei do site, adicionei a lista de recursos para utilizar
Diogo, faz um video explicando as ferramentas que voce usa no Mac, mais de maneira externa, as configurações do safari, IA embutida, shortcuts, vc parece um robô navegando!
Scalar? Diego mas isso já existe em plugin, como insommia documenter ou postman já fazem quando tem plugins para gerar documentação instalado a partir da collections.
O Scalar vem padrão no Elysia agora, não precisa instalar nada a mais.
quero saber que horas tu faz a live. ou tu so lica a camera, grava os momentso sem transmitir nada e ja passa pro editor do video depois para ele fazer os cortes? eu as vezes acompanho as lives do mayk, mas as vezes não. você seria tbm uma opção de acompanhar teus testes de novas ferramentas.
@gabriellicar
3 ай бұрын
Ele faz live na twitch, a cada 1 ano kk *(brincadeiras a parte) nome: dieegosf
Rolando algo novo pro Ignite?
Qual o melhor pra documentar GraphQL?
fui testar essa acalar, nao consegui ver vantagem. ainda precisa documentar no swagger para usar. ou entao eu testei errado.
Rapaz, eu não saquei. Porque tipo, eu pego uma parada que ta no swagger já documentado, pra outro app documentar de novo com opções de gerar código de como usar. Rapaz, eu achei paia.
@esquilo_atomico
3 ай бұрын
É basicamente um swagger UI alternativo, com visual mais moderno. Não é "documentar dnv", é melhor imaginar como uma skin nova pra sua documentação atual.
@Ddiidev
3 ай бұрын
@@esquilo_atomico Isso ai, eu talvez tenha explicado de uma forma burra, mas do jeito que explicou define. Enfim achei isso paia demais!
@esquilo_atomico
2 ай бұрын
@@Ddiidev comprehensible, have a great day
Uso o Scalar faz um tempinho. Bom demais, muito lindo, melhor que o swagger ui padrão feião.
Ele gera a documentacao baseado no código que voce fornece? (tô conhecendo esse assunto agr KKKKKKK)
@vitvitvitvitvitvitvitvit
2 ай бұрын
baseado no schema do openapi, que é um JSON padronizado para documentações. Geralmente, os frameworks geram sozinho, mas você precisa descrever a rota e definir schemas/models das suas entidades, mas alguns não fazem e você precisar fazer na mão (que é um sacokkkkkkkkkkk).
@ChrisG59
2 ай бұрын
@@vitvitvitvitvitvitvitvit aaah saquei, valeu por tirar a duvida mano :)
Postman faz isso ao publicar a doc
@esquilo_atomico
3 ай бұрын
Não sei como é a integração do postman com o código, mas o lado bom do scalar é que ele serve como uma UI alternativa ao Swagger UI, se você já tem uma documentação OpenAPIv3 que você mantem manualmente ou gera a partir do código (como é feito geralmente) basta adicionar o scalar e pronto, você tem uma interface útil de verdade
onde eu vejo essas lives que o diego faz?
@williamroger9375
3 ай бұрын
Também tenho a mesma curiosidade!
@ivambergsilva591
3 ай бұрын
No canal dele na twitch, eu tava nesse dia, muito massa, ele faz live as vezes, ontem ele tava fazendo um design no figma, mt foda.
@souzannatha
2 ай бұрын
@@ivambergsilva591 qual o canal dele?
@ivambergsilva591
2 ай бұрын
@@souzannatha www.twitch.tv/dieegosf
@ivambergsilva591
2 ай бұрын
@@souzannatha é avisado no discord quando ele ta on. Tanto ele, quanto o Maykão
Corrigindo: Su é ger De resto, muito bom.