Maven Error when building Apex documentation in Windows

When building the Apex documentation on Windows, the following Maven error was observed due to a directory translation needed when building the module sites. So the error message was (one example):

Unresolved directive in <stdin> - include::C:\Users\eramkve\Documents\ONAP_DEV_SETUP\apex-pdp\services\services-engine/examples/examples-myfirstpolicy/src/site-docs/adoc/fragments/01-introduction.adoc

This means that while building an example site, Maven assumed that its ${projecy.base.dir} used in the ADOC path is “services”services-engine/…”. This is obviously wrong, and seems to be a configuration error either in Maven or the command shell from the previous module built, which is services and thus services-engine.

It is not known where this error comes from. If it happens again, We recommend to close the command shell On Windows, so probably the “cmd” shell), then opening a new one and run all 4 site commands (starting with mvn clean) again.