Changes to revised documentation

[Jeremy CAVANAGH]

Hi Antonio,
 
Sorry about the last email I'm using Orange.fr webmail and it clearly truncated 
message without saving a copy?
 
Anyway, I've just tried running again using ./gradlew clean buildSite run 
--info with the result: 
 
*.asciidoc can not be merged because the corresponding YAML file *.asciidoc.yml 
was not found.
 
For several 'hundred' entries. I s this of significance.
 
Regards
 
Jeremy