Undici seems to be an HTTP 1.1 client. Is there any work or timescale to provide HTTP 2 support?

check https://www.npmjs.com/package/rekwest

Not yet but it's planned to eventually happen.

Nice project. First stargazer! If you add the GitHub topic `openapi3` it will get picked up and indexed by https://apis.guru/awesome-openapi3/

> Support JSON (only YAML for the moment)

JSON is a subset of YAML, so this should "just work" with no changes... Oh, I see, it autoconverts JSON to YAML at the moment so needs a JSON mode.

Does it not support the OPTIONS and TRACE methods?

Typo: "Deuplicate" for "Duplicate"

Really thanks for your suggestions :) More improvements in next release

You can do both. Widdershins converts an OpenAPI definition to the markdown format used by Slatedocs. https://github.com/mermade/Widdershins

Oooh, nice. That looks potentially useful.

For people who haven’t clicked the link, this assumes you’re defining your API in OpenAPI/Swagger/a few other options, and (one directionally) converts it to suitable formats for static publishing:

Widdershins is generally used as a stage in an API documentation pipeline. The pipeline begins with an API definition in OpenAPI 3.x, OpenAPI 2.0 (fka Swagger), API Blueprint, AsyncAPI or Semoasa format. Widdershins converts this description into markdown suitable for use by a renderer, such as Slate, ReSlate, Shins (deprecated) or html suitable for use with ReSpec.

Widdershins works pretty well. IIRC their README also links to a CLI tool that wraps Widdershins.

I containerized it and added some wrapper scripts so we can just drop the YAML spec in our repo and have build automation to generate/deploy a web site with all the relevant docs.

I saw this and I'm definitely leaning towards it now given what was said in this thread. Thanks!

Does your API have an OpenAPI definition?

It does :) You can find it at the top of the page at https://docs.enode.io

Thanks! And it validates fine, congratulations. API added to the APIs.guru OpenAPI Directory.

Do you recommend OpenAPI based docs? I used SlateDocs for mine: https://butterflylabs.gitlab.io/api-documentation because I found that generating OpenAPI with NestJS to be kind of a pain as part of a build process.

Oh nice! Thank you so much :)

Congratulations! Will add your OpenAPI definition to the APIs.guru OpenAPI Directory.

That's really cool, thank you. Lmk if there's any information you'd need from me.

Great to see it has an OpenAPI definition too. Added to the APIs.guru OpenAPI Directory.

You might want to look at https://github.com/slatedocs/slate - there is also a Node.js port https://github.com/mermade/reslate and tools (see the slate wiki) to convert from formats such as OpenAPI

that's exactly what I was looking for, many thanks!

Quis archiviet ipsos archives?

halfbakery.com - and it's still (half) going.

Modern short story? Russian inwention!