Henry Andrews
Henry Andrews
Our quality levels on the meta-schemas have been unacceptable (and I'm the one who has made most of the meta-schema changes, so I'm primarily criticizing myself here, although the problem...
Media type parameters are problematic due to requiring the media type to agree to and register the parameter. Media types such as `application/json` are reluctant to do so (e.g. refusing...
JSON Schema [draft 2019-09](https://json-schema.org/draft/2019-09/json-schema-core.html) (formerly known as [draft-08](https://json-schema.org/specification-links.html#table-of-all-versions-of-everything)) introduced [several changes](https://json-schema.org/draft/2019-09/json-schema-core.html#rfc.section.8.2) around `$ref` and `$id`. This draft is [being adopted](https://github.com/OAI/OpenAPI-Specification/pull/1977) by the OpenAPI Specification version 3.1. * The plain-name fragment...
The new `@cloudflare/doca` probably doesn't work any better on Windows than the old. * `require` paths in schema.js use forward slashes * when generating form data file upload curl examples,...
As filed by @Relequestual as cloudflare/doca#40 > When creating a theme with multiple css files in the styles folder, not all of them are always pick up and included. >...
As filed by @TexKiller as cloudflare/doca#77 > If the project_folder is specified outside of the current directory, such as with `doca init -i ../schemas -o ../documentation`, the json schemas paths...
As filed by @shengu as cloudflare/doca#78 > Better to allow user to set `title` via `doca init` so that the the value is set to config.js.
`@cloudflare/json-schema-transform` currently only understands singular `example` (a Doca-specific keyword), but in draft-06 `examples` was adopted into the standard. Rolling up arrays of examples is more complicated, but some sort of...
JavaScript does not reliably preserve object field ordering, and it is not trivial to hook `JSON.parse()` to produce a data structure that does. There are several possible solutions. The JSON...
Equivalent of cloudflare/doca#5 `baseUri` is used for the base when resolving `href` for examples. With draft-04 it is the only way to do so. draft-06+ have `base`, so this isn't...