<html>
  <head>
    <meta content="text/html; charset=windows-1252"
      http-equiv="Content-Type">
  </head>
  <body text="#000000" bgcolor="#FFFFFF">
    <p>Thanks for the information.  I haven't done forks or requests
      with Github.  I appreciate the offer and at some point my take you
      up on it but right now I'm swamped and just can't handle one more
      thing and it sounds like the fork/pull is not trival.  I things
      slow down I'll try and get back to you on it.  Right now it's a
      LibreOffice document that I made from the notes I did in a text
      editor while struggling with the install.</p>
    <p><br>
    </p>
    <br>
    <div class="moz-cite-prefix">On 09/04/2016 06:59 PM, Tom Gamull
      wrote:<br>
    </div>
    <blockquote
      cite="mid:CEB7733D-64BE-46D4-9177-A7C09C4CD0ED@redhat.com"
      type="cite">
      <meta http-equiv="Content-Type" content="text/html;
        charset=windows-1252">
      The docs do suck but I would challenge you to submit a pull
      request.  It’s a pain if you haven’t done github forks and pull
      requests.  However, if you do this and it doesn’t get merged, you
      have every right to complain and I’ll be behind you 100%.  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 moz-do-not-send="true"
                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.   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.  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.  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;).  I took
                  a lot of notes  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.  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? 
                      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. </p>
                    <p style="margin-bottom:0in;line-height:100%"
                      class=""><a moz-do-not-send="true"
                        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.  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.  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"
                        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?  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"
                        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?  Do
                      you need to use virsh to connect to the VM?  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"
                        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=""> 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 class="" wrap="">_______________________________________________
Users mailing list
<a moz-do-not-send="true" class="moz-txt-link-abbreviated" href="mailto:Users@ovirt.org">Users@ovirt.org</a>
<a moz-do-not-send="true" 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 moz-do-not-send="true" href="mailto:Users@ovirt.org"
                class="">Users@ovirt.org</a><br class="">
              <a class="moz-txt-link-freetext" href="http://lists.ovirt.org/mailman/listinfo/users">http://lists.ovirt.org/mailman/listinfo/users</a><br class="">
            </div>
          </blockquote>
        </div>
        <br class="">
      </div>
    </blockquote>
    <br>
  </body>
</html>