<html><head><meta http-equiv="Content-Type" content="text/html charset=utf-8"></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" class=""><div class="">I'm might be saying things in a harsh way, but there is a real big problem with public documentation at ovirt, especially the latest python sdk.</div><div class=""><br class=""></div><div class="">I'm coding a python wrapper around the sdk4 and fighting a lot with documentation. </div><div class=""><br class=""></div><div class="">First I tried to google:</div><div class="">ovirt python sdk4</div><div class="">ovirt python sdk 4</div><div class="">ovirt rest api 4</div><div class=""><br class=""></div><div class="">I was finally given <a href="http://ovirt.github.io/ovirt-engine-sdk/master" class="">http://ovirt.github.io/ovirt-engine-sdk/master</a>, but <a href="http://ovirt.github.io" class="">http://ovirt.github.io</a> returns a 404, the sdk is hidden under <a href="http://ovirt.github.io/ovirt-engine-sdk/" class="">http://ovirt.github.io/ovirt-engine-sdk/</a>, a mini-site that is barely usable, as it very hard to navigate between page. For example, when you're at : <a href="http://ovirt.github.io/ovirt-engine-sdk/master/version.m.html" class="">http://ovirt.github.io/ovirt-engine-sdk/master/version.m.html</a>, how do you go to the first page ?</div><div class=""><br class=""></div><div class="">If I try to gogle the title of this page, I found <a href="http://www.ovirt.org/develop/release-management/features/infra/python-sdk/" class="">http://www.ovirt.org/develop/release-management/features/infra/python-sdk/</a> as first result and it's even not in the first page of results .</div><div class=""><br class=""></div><div class="">Or you can have a look at <a href="https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/python_sdk_guide/" class="">https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html-single/python_sdk_guide/</a>, that talks only about v3 sdk, which is deprecated.</div><div class=""><br class=""></div><div class="">The python sdk change log:</div><div class=""><a href="http://www.ovirt.org/develop/sdk/python-sdk-changelog/" class="">http://www.ovirt.org/develop/sdk/python-sdk-changelog/</a></div><div class=""><br class=""></div><div class="">At pypi, no links to the sdk documentation</div><div class=""><a href="https://pypi.python.org/pypi/ovirt-engine-sdk-python" class="">https://pypi.python.org/pypi/ovirt-engine-sdk-python</a></div><div class=""><br class=""></div><div class="">I requested the events codes, I was given that:</div><div class=""><a href="https://github.com/oVirt/ovirt-engine/blob/master/backend/manager/modules/common/src/main/java/org/ovirt/engine/core/common/AuditLogType.java#L726" class="">https://github.com/oVirt/ovirt-engine/blob/master/backend/manager/modules/common/src/main/java/org/ovirt/engine/core/common/AuditLogType.java#L726</a></div><div class=""><br class=""></div><div class="">Is there a formal list somewhere ?</div><div class=""><br class=""></div><div class=""><div><blockquote type="cite" class=""><div class="">Le 10 mai 2017 à 08:21, Oved Ourfali <<a href="mailto:oourfali@redhat.com" class="">oourfali@redhat.com</a>> a écrit :</div><br class="Apple-interchange-newline"><div class=""><div dir="ltr" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><div class="gmail_extra"><br class="Apple-interchange-newline"><br class=""><div class="gmail_quote">On Tue, May 9, 2017 at 11:46 PM, Fabrice Bacchella<span class="Apple-converted-space"> </span><span dir="ltr" class=""><<a href="mailto:fabrice.bacchella@orange.fr" target="_blank" class="">fabrice.bacchella@orange.fr</a>></span><span class="Apple-converted-space"> </span>wrote:<br class=""><blockquote class="gmail_quote" style="margin: 0px 0px 0px 0.8ex; border-left-width: 1px; border-left-style: solid; border-left-color: rgb(204, 204, 204); padding-left: 1ex;"><div style="word-wrap: break-word;" class="">I'm whining because ovirt is a wonderful product, peoples behind are nice, but ho boy, what about the execution !<div class=""><br class=""></div></div></blockquote><div class=""><br class=""></div><div class="">I couldn't agree more with James here.</div><div class="">It is good to whine, complain, and seek for improvements. We all want a better project!</div><div class="">However, there are pleasant ways to express your thoughts and concerns. You seem to choose unpleasant ones, which are also unproductive and insulting to others.</div><div class="">That can result in people not taking your thoughts and concerns in a serious way, as it is just unpleasant for them to read and reply to.</div><div class="">I remember someone already sent you the community code of conduct [1]. I suggest you read that again before sharing your next post with us.</div><div class=""><br class=""></div><div class="">Oved<br class=""></div><div class=""> </div><div class="">[1] <a href="https://www.ovirt.org/community/about/community-guidelines/" class="">https://www.ovirt.org/community/about/community-guidelines/</a></div><div class=""><br class=""></div><blockquote class="gmail_quote" style="margin: 0px 0px 0px 0.8ex; border-left-width: 1px; border-left-style: solid; border-left-color: rgb(204, 204, 204); padding-left: 1ex;"><div style="word-wrap: break-word;" class=""><div class=""></div><div class="">And no I have done much more than empty complains as I have open my share a bug report, written a blog entry about using ovirt+kerberos+SSO, written a full fledged CLI and trying to finished the SDK. So I'm not just complaining.</div><div class=""><div class="gmail-h5"><div class=""><br class=""><div class=""><blockquote type="cite" class=""><div class="">Le 9 mai 2017 à 22:28, James Michels <<a href="mailto:karma.sometimes.hurts@gmail.com" target="_blank" class="">karma.sometimes.hurts@gmail.<wbr class="">com</a>> a écrit :</div><br class="gmail-m_5139079229713401712Apple-interchange-newline"><div class=""><div dir="ltr" class="">Seriously, what's wrong with you? I've being reading your comments for some time and the only things I see are whining, unproductive complaining and disrespectful comments.<div class=""><br class=""></div><div class="">Please, stop it. There are tons of ways to say something, and the way you use is insulting for dozens of people developing this project. Most people here are seeking help and/or trying to be useful aiding others in what they can. If you don't like oVirt or you have that much complains maybe you should start your project yourself and do things like you consider they should be done.</div><div class=""><br class=""></div><div class="">James<br class=""><div class="gmail_extra"><br class=""><div class="gmail_quote">2017-05-09 15:59 GMT+01:00 Fabrice Bacchella<span class="Apple-converted-space"> </span><span dir="ltr" class=""><<a href="mailto:fabrice.bacchella@orange.fr" target="_blank" class="">fabrice.bacchella@orange.fr</a>></span>:<br class=""><blockquote class="gmail_quote" style="margin: 0px 0px 0px 0.8ex; border-left-width: 1px; border-left-style: solid; border-left-color: rgb(204, 204, 204); padding-left: 1ex;"><div style="word-wrap: break-word;" class="">The documentation is alway a good laugh at ovirt. Look for RHEL instead.<div class=""><br class=""><div class=""><blockquote type="cite" class=""><div class=""><div class="gmail-m_5139079229713401712h5"><div class="">Le 9 mai 2017 à 16:13, Juan Pablo <<a href="mailto:pablo.localhost@gmail.com" target="_blank" class="">pablo.localhost@gmail.com</a>> a écrit :</div><br class="gmail-m_5139079229713401712m_8030520292843597762Apple-interchange-newline"></div></div><div class=""><div class=""><div class="gmail-m_5139079229713401712h5"><div dir="ltr" class=""><div class=""><div class="">Team, Is just me or the documentation pages are not being updated ? many are outdated.. how can we collaborate?<span class="Apple-converted-space"> </span><br class=""><br class="">whats up with<span class="Apple-converted-space"> </span><a href="http://www.ovirt.org/documentation/admin-guide/" target="_blank" class="">http://www.ovirt.org/documenta<wbr class="">tion/admin-guide/</a><span class="Apple-converted-space"> </span>?<br class=""><br class=""></div>regards,<br class=""></div>JP<br class=""></div></div></div>______________________________<wbr class="">_________________<br class="">Users mailing list<br class=""><a href="mailto:Users@ovirt.org" target="_blank" class="">Users@ovirt.org</a><br class=""><a href="http://lists.ovirt.org/mailman/listinfo/users" target="_blank" class="">http://lists.ovirt.org/mailman<wbr class="">/listinfo/users</a><br class=""></div></blockquote></div><br class=""></div></div><br class="">______________________________<wbr class="">_________________<br class="">Users mailing list<br class=""><a href="mailto:Users@ovirt.org" target="_blank" class="">Users@ovirt.org</a><br class=""><a href="http://lists.ovirt.org/mailman/listinfo/users" rel="noreferrer" target="_blank" class="">http://lists.ovirt.org/mailman<wbr class="">/listinfo/users</a><br class=""><br class=""></blockquote></div><br class=""></div></div></div>______________________________<wbr class="">_________________<br class="">Users mailing list<br class=""><a href="mailto:Users@ovirt.org" target="_blank" class="">Users@ovirt.org</a><br class=""><a href="http://lists.ovirt.org/mailman/listinfo/users" target="_blank" class="">http://lists.ovirt.org/<wbr class="">mailman/listinfo/users</a><br class=""></div></blockquote></div><br class=""></div></div></div></div><br class="">______________________________<wbr class="">_________________<br class="">Users mailing list<br class=""><a href="mailto:Users@ovirt.org" class="">Users@ovirt.org</a><br class=""><a href="http://lists.ovirt.org/mailman/listinfo/users" rel="noreferrer" target="_blank" class="">http://lists.ovirt.org/<wbr class="">mailman/listinfo/users</a><br class=""><br class=""></blockquote></div><br class=""></div></div><span style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;" class="">_______________________________________________</span><br style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><span style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px; float: none; display: inline !important;" class="">Users mailing list</span><br style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><a href="mailto:Users@ovirt.org" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class="">Users@ovirt.org</a><br style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class=""><a href="http://lists.ovirt.org/mailman/listinfo/users" style="font-family: Helvetica; font-size: 12px; font-style: normal; font-variant-caps: normal; font-weight: normal; letter-spacing: normal; orphans: auto; text-align: start; text-indent: 0px; text-transform: none; white-space: normal; widows: auto; word-spacing: 0px; -webkit-text-stroke-width: 0px;" class="">http://lists.ovirt.org/mailman/listinfo/users</a></div></blockquote></div><br class=""></div></body></html>