vrepsys
Joined 14 years ago
Karma
313
Submissions
77
Member since
May 8
Recent submissions
Comment · 4 years ago
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.
Comment · 4 years ago
Appreciate the feedback.
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?
Comment · 4 years ago
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
Here are a couple of example docs: https://space-api.portaldocs.dev (and the OpenAPI behind it: https://github.com/portaldev/nasa-apod-api-docs/blob/main/op...)
https://recur-api-beta.portaldocs.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.
Comment · 4 years ago
Hey HN,
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.
Any feedback/thoughts highly appreciated!
Comment · 4 years ago
> 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].
[1] https://www.lrt.lt/en/news-in-english/19/1569623/china-threa...
[2] https://www.politico.eu/article/lithuania-taiwan-china-micro...
Comment · 4 years ago
It has to do with gas, because 12% of electricity in Germany is produced by burning natural gas. That's up by 4pp from 2018.
That's according to wikipedia:
https://en.wikipedia.org/wiki/Electricity_sector_in_Germany
Comment · 5 years ago
How about on demand page revalidation* ? I can't find if it's part of Next 12.
* https://github.com/vercel/next.js/discussions/11552#discussi...
Comment · 5 years ago
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.
Comment · 5 years ago
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.
Comment · 5 years ago
The EU has failed to secure contracts ensuring the EU produced vaccine stays in the EU[1].
So far the EU has exported 41.6 million doses of the vaccine (the largest importer being the UK)[2]. Both the US and the UK have exported 0 vaccines.
[1] https://twitter.com/davekeating/status/1372897635577761803
[2] https://twitter.com/AlexTaylorNews/status/137362147260701081...
Building prose.ui.com (UI for tech docs) and dhub.dev (dev tooling).
Strong in frontend systems, backend APIs, and product execution.
Available for contract work.