-* if you think the content is generic enough to be of interest for all users,
-then you should try to get it into the reference documentation. The reference
-documentation is written in the easy to use 'asciidoc' document format.
-Editing the official documentation requires to clone the git repository at
-`git://git.proxmox.com/git/pve-docs.git` and then follow the
-https://git.proxmox.com/?p=pve-docs.git;a=blob_plain;f=README.adoc;hb=HEAD[REAME.adoc] document.
-
-Improving the documentation is just as easy as editing a Wikipedia
-article and is an interesting foray in the development of a large
-opensource project.
+* The reference documentation: For general content that will be helpful to all
+ users please propose your contribution for the reference documentation. This
+ includes all information about how to install, configure, use, and
+ troubleshoot {pve} features. The reference documentation is written in the
+ https://en.wikipedia.org/wiki/AsciiDoc[asciidoc format]. To edit the
+ documentation you need to clone the git repository at
+ `git://git.proxmox.com/git/pve-docs.git`; then follow the
+ https://git.proxmox.com/?p=pve-docs.git;a=blob_plain;f=README.adoc;hb=HEAD[README.adoc]
+ document.