[pve-devel] [PATCH docs v2 2/3] Add sub chapter on how to improve the reference documentation

Emmanuel Kasper e.kasper at proxmox.com
Mon Oct 3 13:45:40 CEST 2016


---
 pve-intro.adoc | 33 +++++++++++++++++++++++++++++++++
 1 file changed, 33 insertions(+)

diff --git a/pve-intro.adoc b/pve-intro.adoc
index 56d8dd3..0431e09 100644
--- a/pve-intro.adoc
+++ b/pve-intro.adoc
@@ -240,3 +240,36 @@ The most notable change with version 4.0 was the move from OpenVZ to
 https://linuxcontainers.org/[LXC]. Containers are now deeply
 integrated, and they can use the same storage and network features
 as virtual machines.
+
+Improving the {pve} documentation
+---------------------------------
+
+Depending on which issue you want to improve, you can use a variety of
+communication mediums to reach the developers.
+
+If you notice an error in the current documentation, use the·
+http://bugzilla.proxmox.com[Proxmox bug tracker] and propose an·
+alternate text/wording.
+
+If you want to propose new content, it depends on what you want to
+document:
+
+* if the content is specific to your setup, a wiki article is the best
+option. For instance if you want to document specific options for guest
+systems, like which combination of Qemu drivers work best with a less popular
+OS, this is a perfect fit for a wiki article.
+
+* if you think the content is generic enough to be of interest for all users,
+then you should try to get it in 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.
+
+NOTE: If you are interested in working on the {pve} codebase, the
+https://pve.proxmox.com/wiki/Developer_Documentation[Developer
+Documentation] wiki article will show you where to start.
-- 
2.1.4





More information about the pve-devel mailing list