Ignored RAML issue: Missing required documentation properties

[postatum]

Issue

Running code below with each of the RAML inputs provided should fail or report validation error because according to RAML 1.0 spec provided RAML inputs are invalid.

The spec says:

title ... Its value MUST be a non-empty string.
content ... Its value MUST be a non-empty string and MAY be formatted using markdown.

Spec link:
https://github.com/raml-org/raml-spec/blob/master/versions/raml-10/raml-10.md#user-documentation

amf-client-js version

3.1.9

RAML Inputs

#%RAML 1.0
title: ZEncoder API
documentation:
 - title:
   content:

#%RAML 1.0
title: ZEncoder API
documentation:
 - title: Welcome
   content:

#%RAML 1.0
title: ZEncoder API
documentation:
 - title:
   content: |
     Welcome to the _Zencoder API_ Documentation.

JavaScript Code

const amf = require('amf-client-js')

const ramlStr = ''  // Pick one of the above RAML inputs

async function main () {
  await amf.AMF.init()
  const model = await amf.AMF.raml10Parser().parseStringAsync(ramlStr)
  let report
  try {
    report = await amf.AMF.validate(
      model, amf.ProfileNames.RAML10, amf.MessageStyles.RAML)
  } catch (e) {
    console.log(e.toString())
  }
  if (!report.conforms) {
    report.results.map(res => {
      console.log(`${res.level} - ${res.message}`)
    })
  }
}

main()

[tomsfernandez]

Hi @postatum. I have reproduced this in AMF's latest version and will be creating an internal ticket to keep track of this problem issue.

We will provide further updates in this Github issue thread.

Internal ticket: https://www.mulesoft.org/jira/browse/APIMF-2174

[arielmirra]

This issue has been fixed in this PR and will be available in our next release (September 23th 2020)