Rest API schema files files do not validate and present errors if edited with tools such as MS Visual Studio or Altova XML Spy.
The issue can be verified with Netbeans as well.
- select all xsd files in vendor/ezsystems/ezpublish-kernel/doc/specifications/rest/xsd/
- right click on the list of files and select Validate XML
=> Errors such as the following will be showed