PlatformOfTrust/docs

Generating docs locally doesn't work

Opened this issue · 0 comments

Describe the pain in using this API

Following the README, I get all the way until running CODE_EXAMPLES="../code-examples" python build.py in raml2markdown folder. This generates the following errors:

Converting acl-api to Slate
Delete previous API doc files
File: acl-api.md delete failed. MD formatted file not found!
/usr/bin/env: ‘node --harmony’: No such file or directory
RAML -> OpenAPISpec failed. Trying next in array.

... Continues for all docs ...

Converting product-api to Slate
Delete previous API doc files
File: product-api.md delete failed. MD formatted file not found!
/usr/bin/env: ‘node --harmony’: No such file or directory
RAML -> OpenAPISpec failed. Trying next in array.
Traceback (most recent call last):
  File "build.py", line 224, in <module>
    concatenate_files(os.environ[code_examples_var])
  File "build.py", line 111, in concatenate_files
    infile = open(slatefile, 'r').readlines()
FileNotFoundError: [Errno 2] No such file or directory: 'slate/acl-api.md'

Using:
Ubuntu 18.04.3 LTS
node version v11.1.0

Indicate the importance in number

  1. Critical