DEV Community

Discussion on: Slate, Swagger, and Silos - A Documentation Rebuild Story

preciselyalyss profile image
Alyss 💜 Author

Sorry, I was trying to clarify what file type you'd be working with. Is there a way to export existing markdown files or swagger/OAS from postman and is that what you'll be using?

Thread Thread
fgadaleta profile image
frag

Ok, my attempt is to use Postman for debugging and writing the doc. But Slate to publish. So I'd need postman to export a json that I can somehow convert for Slate

Thread Thread
preciselyalyss profile image
Alyss 💜 Author

Depending on the file output, you might have an easier time with a project that could just consume open api spec out of the box. Box custom built their dev docs and pull from their open api spec repository. You can see some code here but I don't believe an arch diagram has been published github.com/box/developer.box.com