DEV Community

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

Collapse
 
fgadaleta profile image
frag

is there a way to export from postman and import to slate?

Collapse
 
preciselyalyss profile image
Alyss 💜

Are you exporting the postman docs or the api request collection?

Collapse
 
fgadaleta profile image
frag

for now i'd be happy with documentation only

Thread Thread
 
preciselyalyss profile image
Alyss 💜

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 💜

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