I'm considering of making the OpenAPI->API Reference converter an Open Source project, and then charging only if you need advanced features, like wysiwyg/inline editing, change approvals, automatic testing of the examples in the docs etc.
It's just that I'm not sure I can do it until I have these advanced features. If I can't make money out of this I have to return to my day job, and stop developing portal.dev.
Would it work for you if you could export this as a static website that you could run on your own servers? (you could do that in a Github action), or, alternatively, use some sort of React component that renders the API docs in your app?
Shameless plug: here's my indie-project that converts an OpenAPI/Swagger spec into something that aims to look like Stripe's API Reference:
https://portal.dev
At my previous workplace we've built the whole docs portal (including the API reference) as a custom static website with Contentful (a json CMS) underneath.
It was a real pain in the ass to edit and maintain, that's how I got the idea.
I'm building a tool to render Stripe-like API docs from OpenAPI/Swagger files.
I thought that the best way to get people to discover my tool and be useful at the same time is to build docs for various open APIs.
(Let me know if you need API docs for your open, or even better, an open source API, and I'll make it happen!).
How it works:
- The OpenAPI/Swagger is stored on S3 and rendered on the server-side using NextJs (on Vercel).
- I use NextJs's incremental static rendering (ISR) to render the doc in the background.
- NextJs's middleware (a new thing in NextJs 12) routes the request to an appropriate route based on the subdomain.
- I'm looking to make the docs generator an open source in the future, when I build out the editing feature which will be paid.
> It claimed that one Xiaomi phone had built-in censorship tools while another Huawei model had security flaws.
> Xiaomi’s flagship Mi 10T [...] could detect and censor terms including “Free Tibet”, "Long live Taiwan independence" or "democracy movement", the report said.
This phone thing, as well as Lithuania allowing to the word Taiwan in "Taiwanese Representative Office in Lithuania" were the reasons for economic pressure and unofficial sanctions from China [1].
Meanwhile Taiwan is making a big effort to strengthen economic relations with Lithuania, including investments in the semiconductor industry in Lithuania [2].
Found this endpoint while exploring GitHub's openapi specs. It returns a random phrase like 'Keep the flow going'. It rotates the phrase every 5 seconds or so.
The UK has partially funded AZ and added a clause into the contract that will prioritise UK for future vaccine exports from the UK. And that's exactly what's happening, all AZ produced in UK stays in UK)
Whereas a similar contract between Germany and Biontech (Germany paid biontech $445 million to help develop the vaccine) didn't include a clause defining export priorities.
Pfizer-Biontech is exported all over the world.
Canada, for example, gets their Pfizer-Biontech from the EU, instead of Michigan where they're also produced.
I wouldn’t be surprised if I saw this in a mad max convoy. But in a good sense. Love the minimalist industrial design.
I’m sure it would raise some eyebrows if I rode this on a street where I live. I’m not sure however I’d ever want this as my main vehicle (unless I’m in a postapocalyptic mad max scenario where this would be a must).
It's just that I'm not sure I can do it until I have these advanced features. If I can't make money out of this I have to return to my day job, and stop developing portal.dev.