[Documentation] Assistance Needed with User-Facing Documentation

All: The Red Hat ECS team has made a great effort to convert some of the more important downstream documentation to a MediaWiki format that we can post on oVirt.org as an official set of user- and admin-facing documentation. This is being done as a bootstrapping effort to get our upstream documentation up to date and take a big step towards making the upstream documentation the canonical source for documentation in the near future. Before that can happen, we need to get this RHEV-oriented information ported over to oVirt nomenclature and screenshots taken for oVirt and added to the documents as well. I have placed the three guides * Administration Guide[1] * User's Guide[2] * Installation Guide[3] on the oVirt site as unlinked pages. General wording has been changed from RHEV to oVirt, but not always. Each of these documents must be reviewed and completely adapted to oVirt 3.4 before they can be posted as official documentation. Specifically: * Review all text to ensure proper steps and descriptions for oVirt features and procedures * Review all text to remove downstream-specific text * Review all code for changes in package names on on-screen displays * Replace all downstream RHEV screenshots with upstream oVirt 3.4 screenshots (Max width: 1024px) I will be stepping through these documents to edit them in more detail under these guidelines, but help is most assuredly needed, in order to get this done in a timely manner. oVirt.org wiki users can visit these pages, review them, and add their changes. MediaWiki has limited version control, so it would be best to edit sections instead of entire documents, to minimize stepping on others' changes. Editing by section will also help us track the sections that have been edited, using the pages' histories. Thank you in advance for all of your help on this project... when finished, this will represent a significant improvement to oVirt's documentation, and make oVirt that much easier to use. Peace, Brian [1] http://www.ovirt.org/DraftAdministrationGuide [2] http://www.ovirt.org/DraftUserGuide [3] http://www.ovirt.org/DraftInstallationGuide -- Brian Proffitt oVirt Community Manager Project Atomic Community Lead Open Source and Standards, Red Hat - http://community.redhat.com Phone: +1 574 383 9BKP IRC: bkp @ OFTC

-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 On 07/10/2014 12:09 PM, Brian Proffitt wrote:
[1] http://www.ovirt.org/DraftAdministrationGuide [2] http://www.ovirt.org/DraftUserGuide [3] http://www.ovirt.org/DraftInstallationGuide
Just a tip that MediaWiki prefers spaces in names (and all page names in flat format rather than /Fake/Nesting.) You'll probably want to rename those pages to e.g. [[Draft Administration Guide]]. http://www.ovirt.org/index.php?search=Guide&fulltext=Search You'll notice that the above links don't appear in the page title search results - the search tool doesn't pull out strings from CamelCaseStylePages. You may also want to put these in the [[Category:Documentation]] or [[Category:Draft documentation]]. http://www.ovirt.org/Category:Documentation Although the wiki is full of pages that break these rules, here are the guidelines for writing on the wiki: http://www.ovirt.org/Category:Documentation_for_writing_on_the_wiki These are derived from/truthful toward the MediaWiki and Wikipedia standards, with content source originally from the Fedora Project wiki. - - Karsten - -- Karsten 'quaid' Wade .^\ CentOS Doer of Stuff http://TheOpenSourceWay.org \ http://community.redhat.com @quaid (identi.ca/twitter/IRC) \v' gpg: AD0E0C41 -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/ iEYEARECAAYFAlO+8WYACgkQ2ZIOBq0ODEGkqwCg1h6Qms1J3KYmOVK9yI3tGjHH Ld0AnjX2aKRsjXdjsDbYOyCx5odxa/De =Q4lI -----END PGP SIGNATURE-----
participants (2)
-
Brian Proffitt
-
Karsten Wade