<html><head><meta http-equiv="Content-Type" content="text/html charset=windows-1252"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class="">The docs do suck but I would challenge you to submit a pull request. &nbsp;It’s a pain if you haven’t done github forks and pull requests. &nbsp;However, if you do this and it doesn’t get merged, you have every right to complain and I’ll be behind you 100%. &nbsp;I’ve been in your shoes and just recently started helping in little bits on some projects.<div class=""><br class=""></div><div class="">If you can fork the documents, change them to include your notes, I’d be happy to hand hold or explain how to do the pull request (think merging your changes back). you can even email me direct if needed.</div><div class=""><br class=""></div><div class="">Tom Gamull</div><div class=""><br class=""></div><div class="">
<br class=""><div><blockquote type="cite" class=""><div class="">On Sep 4, 2016, at 4:26 PM, Brett I. Holcomb &lt;<a href="mailto:biholcomb@l1049h.com" class="">biholcomb@l1049h.com</a>&gt; wrote:</div><br class="Apple-interchange-newline"><div class="">
  
    <meta content="text/html; charset=windows-1252" http-equiv="Content-Type" class="">
  
  <div text="#000000" bgcolor="#FFFFFF" class=""><p class="">Yeah, its frustrating for sure as I spent a lot of wasted time
      trying to figure out what applied, what didn't, what was out of
      date and a lot of what did apply assumed I already knew parts I
      needed. &nbsp; I came from VMware and Hyper-V worlds and really like
      oVirt and what it's doing but the documentation can be frustrating
      for sure.&nbsp; Unfortunately, that seems to be the way of a lot of
      OpenSource and along with that very few people like to do
      documentation and when they do it's from the perspective of
      someone who already knows the answers so it really doesn't help a
      brand new person who has no clue.&nbsp; I had to do several hosted
      engine installs before I got it working (the stupid installer
      can't recover from an error so it makes you start over) on 3.6
      (thanks be to VMware Workstation that let me start over
      &lt;G&gt;).&nbsp; I took a lot of notes&nbsp; and when I get time I'll post
      them. I know some will say we should contribute to the docs but I
      know I already have a full schedule with work and family and can't
      do anymore.</p><p class="">I've found this mailing list is the best source of information
      and sometimes they can link to sources we haven't found.&nbsp; The
      people in this group are really knowledgeable and helpful so until
      the do get updated docs ask here.</p>
    On 09/04/2016 04:14 PM, zero four wrote:<br class="">
    <blockquote cite="mid:CACBeWZOZMUxKAPVWZFvv08pC1zMRJ=B8Hafcubqxn3pJrHaGrw@mail.gmail.com" type="cite" class="">
      <div dir="ltr" class=""><p style="margin-bottom:0in;line-height:100%" class="">As a prospective
          user of oVirt I have noticed quite a lot of glaring problems
          with the documentation, is it still being maintained?&nbsp; Since
          outdated or incomplete documentation is often worse than
          nothing, a possible solution would be to just link to the
          official Red Hat Virtualization documentation.</p><p style="margin-bottom:0in;line-height:100%" class="">Here are some
          examples I found after looking for less than 5 minutes:</p><p style="margin-bottom:0in;line-height:100%" class="">1.&nbsp;</p><p style="margin-bottom:0in;line-height:100%" class=""><a moz-do-not-send="true" href="http://www.ovirt.org/documentation/" class=""></a><a class="moz-txt-link-freetext" href="http://www.ovirt.org/documentation/">http://www.ovirt.org/documentation/</a></p><p style="margin-bottom:0in;line-height:100%" class="">The top of this
          web page has two videos from 2012. The left one "oVirt Open
          Virtualization Basics -- Single Machine Install" is a guide
          for the all in one install.&nbsp; This is misleading as it no
          longer possible to perform an all in one install since 3.6,
          and in general it would appear the oVirt project does not
          support deploying oVirt to a single machine. The right video
          is a guide on creating VMs using the GUI from 2012 which has
          since changed.</p><p style="margin-bottom:0in;line-height:100%" class="">Overall both
          videos should be removed from the Documentation page as they
          only confuse and mislead new users.&nbsp; I, and I am sure many
          other users would greatly appreciate more current video
          guides.<br class="">
        </p><p style="margin-bottom:0in;line-height:100%" class="">2.</p><p style="margin-bottom:0in;line-height:100%" class=""><a moz-do-not-send="true" href="https://www.ovirt.org/documentation/how-to/hosted-engine/#fresh-install" class=""></a><a class="moz-txt-link-freetext" href="https://www.ovirt.org/documentation/how-to/hosted-engine/#fresh-install">https://www.ovirt.org/documentation/how-to/hosted-engine/#fresh-install</a></p><p style="margin-bottom:0in;line-height:100%" class="">Under the notes
          for this there is the following passage:</p><p style="margin-bottom:0in;line-height:100%" class=""><span class="gmail-Apple-tab-span" style="white-space:pre">        </span>“Although
          hosted-engine and engine-setup use different wording for the
          admin password <span class="gmail-Apple-tab-span" style="white-space:pre">        </span>("'admin@internal'
          user password" vs "Engine admin password"), they are asking
          for the same <span class="gmail-Apple-tab-span" style="white-space:pre">        </span>thing.
          If you enter different passwords, the hosted-engine setup will
          fail.”</p><p style="margin-bottom:0in;line-height:100%" class="">Why is the wording
          different?&nbsp; This appears to be entirely unnecessary, and also
          confusing as to why it is asking for the password a second
          time at all.</p><p style="margin-bottom:0in;line-height:100%" class="">3.</p><p style="margin-bottom:0in;line-height:100%" class=""><a moz-do-not-send="true" href="https://www.ovirt.org/documentation/how-to/hosted-engine/#fresh-install" class=""></a><a class="moz-txt-link-freetext" href="https://www.ovirt.org/documentation/how-to/hosted-engine/#fresh-install">https://www.ovirt.org/documentation/how-to/hosted-engine/#fresh-install</a></p><p style="margin-bottom:0in;line-height:100%" class="">After finishing
          the hosted engine deployment script the guide states:</p><p style="margin-bottom:0in;line-height:100%" class=""><span class="gmail-Apple-tab-span" style="white-space:pre">        </span>“After
          completing the OS installation on the VM, return to the host
          and continue. The installer <span class="gmail-Apple-tab-span" style="white-space:pre">        </span>on
          the host will sync with the VM and ask for the <span class="gmail-Apple-tab-span" style="white-space:pre">        </span>engine
          to be installed on the new VM:”</p><p style="margin-bottom:0in;line-height:100%" class="">It is unclear how
          you are expected to access the VM, is the Web UI up at this
          point?&nbsp; Do you need to use virsh to connect to the VM?&nbsp; The
          guide should be explicit.</p><p style="margin-bottom:0in;line-height:100%" class="">4.</p><p style="margin-bottom:0in;line-height:100%" class=""><a moz-do-not-send="true" href="https://www.ovirt.org/documentation/quickstart/quickstart-guide/#prerequisites" class=""></a><a class="moz-txt-link-freetext" href="https://www.ovirt.org/documentation/quickstart/quickstart-guide/#prerequisites">https://www.ovirt.org/documentation/quickstart/quickstart-guide/#prerequisites</a></p><p style="margin-bottom:0in;line-height:100%" class="">&nbsp;I. The
          documentation discusses Fedora 19, Fedora is currently on
          version 24 and 19 is EOL.</p><p style="margin-bottom:0in;line-height:100%" class="">II. Under “Storage
          and Networking” there is no mention that oVirt requires at
          least 3 GlusterFS bricks to achieve quorum.</p><p style="margin-bottom:0in;line-height:100%" class="">III. Under
          “Virtual Machines” there is no mention of Windows 10, Fedora
          past version 20, or RHEL/CentOS 7.X.</p>
      </div>
      <br class="">
      <fieldset class="mimeAttachmentHeader"></fieldset>
      <br class="">
      <pre wrap="" class="">_______________________________________________
Users mailing list
<a class="moz-txt-link-abbreviated" href="mailto:Users@ovirt.org">Users@ovirt.org</a>
<a class="moz-txt-link-freetext" href="http://lists.ovirt.org/mailman/listinfo/users">http://lists.ovirt.org/mailman/listinfo/users</a>
</pre>
    </blockquote>
    <br class="">
  </div>

_______________________________________________<br class="">Users mailing list<br class=""><a href="mailto:Users@ovirt.org" class="">Users@ovirt.org</a><br class="">http://lists.ovirt.org/mailman/listinfo/users<br class=""></div></blockquote></div><br class=""></div></body></html>