openEHR / specifications-ITS-REST

openEHR REST API Specifications
https://specifications.openehr.org/releases/ITS-REST/latest
Apache License 2.0
18 stars 15 forks source link

Error on the development build process #99

Open ppazos opened 1 year ago

ppazos commented 1 year ago

I see an error that repeats by following the steps on the README for building the on the development folder.

Generating HTML file...
redocly build-docs [api]

Produce API documentation as an HTML file

Positionals:
  api                                                                   [string]

Options:
      --version            Show version number.                        [boolean]
      --help               Show help.                                  [boolean]
  -o, --output             Output destination file.
                                         [string] [default: "redoc-static.html"]
      --title              Page title.                                  [string]
      --disableGoogleFont  Disable Google fonts.      [boolean] [default: false]
  -t, --template           Path to handlebars page template, see
                           https://git.io/vh8fP for the example.        [string]
      --templateOptions    Additional options to pass to the template. Use dot
                           notation, e.g. templateOptions.metaDescription
      --theme              Redoc theme.openapi configuration. Use dot notation,
                           e.g. theme.openapi.nativeScrollbars
      --config             Path to the config file.                     [string]

Unknown argument: cdn
ppazos commented 1 year ago

ping @sebastian-iancu

ppazos commented 1 year ago

I found this line on bundle.sh

docker-compose run --rm redocly build-docs computable/OAS/"$1"-html.openapi.json --cdn ...

Removed the --cdn option (which is not documented by redocly CLI) and the error went away.

But I got other errors about references not being resolved. These are not related with the changes I did:

Creating yaml files...
bundling computable/OAS/demographic-codegen.openapi.json...
[1] computable/OAS/demographic-codegen.openapi.json:1077:40 at #/components/schemas/Locatable/discriminator/mapping/COMPOSITION

Can't resolve $ref

1075 | "propertyName": "_type",
1076 | "mapping": {
1077 |     "COMPOSITION": "#\/components\/schemas\/Composition",
1078 |     "EHR_STATUS": "#\/components\/schemas\/EhrStatus",
1079 |     "FOLDER": "#\/components\/schemas\/Folder"

Error was generated by the bundler rule.

[2] computable/OAS/demographic-codegen.openapi.json:1078:39 at #/components/schemas/Locatable/discriminator/mapping/EHR_STATUS

Can't resolve $ref

1076 | "mapping": {
1077 |     "COMPOSITION": "#\/components\/schemas\/Composition",
1078 |     "EHR_STATUS": "#\/components\/schemas\/EhrStatus",
1079 |     "FOLDER": "#\/components\/schemas\/Folder"
1080 | }

Error was generated by the bundler rule.

[3] computable/OAS/demographic-codegen.openapi.json:1079:35 at #/components/schemas/Locatable/discriminator/mapping/FOLDER

Can't resolve $ref

1077 |         "COMPOSITION": "#\/components\/schemas\/Composition",
1078 |         "EHR_STATUS": "#\/components\/schemas\/EhrStatus",
1079 |         "FOLDER": "#\/components\/schemas\/Folder"
1080 |     }
1081 | }

Error was generated by the bundler rule.

[4] computable/OAS/demographic-codegen.openapi.json:1077:40 at #/components/schemas/Locatable/discriminator/mapping/COMPOSITION

Can't resolve $ref

1075 | "propertyName": "_type",
1076 | "mapping": {
1077 |     "COMPOSITION": "#\/components\/schemas\/Composition",
1078 |     "EHR_STATUS": "#\/components\/schemas\/EhrStatus",
1079 |     "FOLDER": "#\/components\/schemas\/Folder"

Error was generated by the bundler rule.

[5] computable/OAS/demographic-codegen.openapi.json:835:53 at #/components/schemas/DvInterval/discriminator/mapping/DV_INTERVAL_of_DATE_TIME

Can't resolve $ref

833 |     "mapping": {
834 |         "DV_INTERVAL": "#\/components\/schemas\/DvInterval",
835 |         "DV_INTERVAL_of_DATE_TIME": "#\/components\/schemas\/DvIntervalOfDateTime"
836 |     }
837 | },

Error was generated by the bundler rule.

[6] computable/OAS/demographic-codegen.openapi.json:835:53 at #/components/schemas/DvInterval/discriminator/mapping/DV_INTERVAL_of_DATE_TIME

Can't resolve $ref

833 |     "mapping": {
834 |         "DV_INTERVAL": "#\/components\/schemas\/DvInterval",
835 |         "DV_INTERVAL_of_DATE_TIME": "#\/components\/schemas\/DvIntervalOfDateTime"
836 |     }
837 | },

Error was generated by the bundler rule.

[7] computable/OAS/demographic-codegen.openapi.json:132:53 at #/components/schemas/DataValue/discriminator/mapping/DV_INTERVAL_of_DATE_TIME

Can't resolve $ref

130 | "DV_IDENTIFIER": "#\/components\/schemas\/DvIdentifier",
131 | "DV_INTERVAL": "#\/components\/schemas\/DvInterval",
132 | "DV_INTERVAL_of_DATE_TIME": "#\/components\/schemas\/DvIntervalOfDateTime",
133 | "DV_MULTIMEDIA": "#\/components\/schemas\/DvMultimedia",
134 | "DV_ORDERED": "#\/components\/schemas\/DvOrdered",

Error was generated by the bundler rule.

[8] computable/OAS/demographic-codegen.openapi.json:132:53 at #/components/schemas/DataValue/discriminator/mapping/DV_INTERVAL_of_DATE_TIME

Can't resolve $ref

130 | "DV_IDENTIFIER": "#\/components\/schemas\/DvIdentifier",
131 | "DV_INTERVAL": "#\/components\/schemas\/DvInterval",
132 | "DV_INTERVAL_of_DATE_TIME": "#\/components\/schemas\/DvIntervalOfDateTime",
133 | "DV_MULTIMEDIA": "#\/components\/schemas\/DvMultimedia",
134 | "DV_ORDERED": "#\/components\/schemas\/DvOrdered",

Error was generated by the bundler rule.