fixed issue #29: In all files of docs/modules/ROOT/pages/

[francoisdh]

  - corrected syntax to use asciidoc instead of markdown especially for sections and blocks of code
  - adopted the "one sentence per line" recommended practice
  - adjusted indent in some blocks
  - improved command lines readability and clarity by putting each argument on a new line