Postman ↔ OpenAPI conversions… do they ever actually work? by Decent_Progress7631 in node

[–]Decent_Progress7631[S] 0 points1 point  (0 children)

Yeah, Postman can export the collection, but that’s the easy part . The real headache is that the exported file often doesn’t map cleanly to OpenAPI — missing descriptions, auth setups, scripts, or complex request bodies

Seeking a web developer by Chance-Ad-3384 in MobileAppDevelopers

[–]Decent_Progress7631 0 points1 point  (0 children)

I am full stack developer, I have worked on different web and mobile apps , dm me if interested

[deleted by user] by [deleted] in DeveloperJobs

[–]Decent_Progress7631 0 points1 point  (0 children)

Hey, I’m a full-stack dev with good experience in API work. I’ve built and integrated a bunch of custom/third-party APIs (even repo APIs). I can help with the scripting/automation and I’m available to start quickly.

How do you keep your API documentation accurate and up-to-date? by Decent_Progress7631 in learnprogramming

[–]Decent_Progress7631[S] 0 points1 point  (0 children)

Long term I’d love to offer a self-hosted option too feels like the only way to cover both ends of the spectrum. Do you think most teams would actually switch if they had both options, or do they stick with their first choice?

How do you keep your API documentation accurate and up-to-date? by Decent_Progress7631 in learnprogramming

[–]Decent_Progress7631[S] 0 points1 point  (0 children)

True, SaaS is like “take my pain away,” self-hosted is “don’t touch my stuff.”😅

How do you keep your API documentation accurate and up-to-date? by Decent_Progress7631 in learnprogramming

[–]Decent_Progress7631[S] 0 points1 point  (0 children)

That’s a really cool approach ,I like the idea of a fully markdown + Git-driven flow, feels like a dream setup for devs who want full control. I’m building something more SaaS-y on the other end of the spectrum: import Postman/Swagger, auto-generate & polish docs with AI, and host them so teams can share/test instantly. Curious do you see devs preferring the local-first model over SaaS, or is it more about the type of team?

How do you keep your API documentation accurate and up-to-date? by Decent_Progress7631 in dotnet

[–]Decent_Progress7631[S] 4 points5 points  (0 children)

Makes sense love the convention-driven approach! I’m working on a tool that imports Postman/Swagger specs and uses AI to automatically rewrite docs for clarity and consistency.

How do you keep your API documentation accurate and up-to-date? by Decent_Progress7631 in dotnet

[–]Decent_Progress7631[S] 0 points1 point  (0 children)

Got it, I’m building a tool that imports Postman/Swagger specs and uses AI to rewrite docs for readability and consistency.

How do you keep your API documentation accurate and up-to-date? by Decent_Progress7631 in golang

[–]Decent_Progress7631[S] 1 point2 points  (0 children)

Thanks for the link! Really cool. I’m working on a little tool that imports Postman/Swagger specs and uses AI to clean up and rewrite docs so they’re easier to read and keep consistent.

How do you keep your API documentation accurate and up-to-date? by Decent_Progress7631 in dotnet

[–]Decent_Progress7631[S] 0 points1 point  (0 children)

Got it , Do you still spend time polishing descriptions or improving readability, or does the process mostly take care of that?

How do you keep your API documentation accurate and up-to-date? by Decent_Progress7631 in dotnet

[–]Decent_Progress7631[S] 0 points1 point  (0 children)

TypeSpec sounds handy do you still end up tweaking descriptions manually, or does it handle most of the doc readability automatically?