--Apple-Mail=_6EF264BF-468F-4E40-9226-B2A9C0F8D42C
Content-Transfer-Encoding: quoted-printable
Content-Type: text/plain;
charset=utf-8
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.
I'm coding a python wrapper around the sdk4 and fighting a lot with =
documentation.=20
First I tried to google:
ovirt python sdk4
ovirt python sdk 4
ovirt rest api 4
I was finally given
http://ovirt.github.io/ovirt-engine-sdk/master, but =
http://ovirt.github.io returns a 404, the sdk is hidden under =
http://ovirt.github.io/ovirt-engine-sdk/, a mini-site that is barely =
usable, as it very hard to navigate between page. For example, when =
you're at : =
http://ovirt.github.io/ovirt-engine-sdk/master/version.m.html, how do =
you go to the first page ?
If I try to gogle the title of this page, I found =
http://www.ovirt.org/develop/release-management/features/infra/python-sdk/=
as first result and it's even not in the first page of results .
Or you can have a look at =
https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/h=
tml-single/python_sdk_guide/, that talks only about v3 sdk, which is =
deprecated.
The python sdk change log:
http://www.ovirt.org/develop/sdk/python-sdk-changelog/
At pypi, no links to the sdk documentation
https://pypi.python.org/pypi/ovirt-engine-sdk-python
I requested the events codes, I was given that:
=
https://github.com/oVirt/ovirt-engine/blob/master/backend/manager/modules/=
common/src/main/java/org/ovirt/engine/core/common/AuditLogType.java#L726
Is there a formal list somewhere ?
Le 10 mai 2017 =C3=A0 08:21, Oved Ourfali <oourfali(a)redhat.com>
a =
=C3=A9crit :
=20
=20
=20
On Tue, May 9, 2017 at 11:46 PM, Fabrice Bacchella =
<fabrice.bacchella(a)orange.fr <mailto:fabrice.bacchella@orange.fr>> =
wrote:
I'm whining because ovirt is a wonderful product, peoples behind
are =
nice, but ho boy, what about the execution !
=20
=20
I couldn't agree more with James here.
It is good to whine, complain, and seek for improvements. We all want =
a better
project!
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.
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.
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.
<
https://www.ovirt.org/community/about/community-guidelines/>
=20
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.
=20
> Le 9 mai 2017 =C3=A0 22:28, James Michels =
<karma.sometimes.hurts(a)gmail.com
=
<mailto:karma.sometimes.hurts@gmail.com>> a =C3=A9crit :
>=20
> 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.
>=20
> 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.
>=20
> James
>=20
> 2017-05-09 15:59 GMT+01:00 Fabrice Bacchella =
<fabrice.bacchella(a)orange.fr
<mailto:fabrice.bacchella@orange.fr>>:
> The documentation is alway a good laugh at ovirt. Look for RHEL =
instead.
>=20
>> Le 9 mai 2017 =C3=A0 16:13, Juan Pablo <pablo.localhost(a)gmail.com =
<mailto:pablo.localhost@gmail.com>> a =C3=A9crit :
>>=20
>> Team, Is just me or the documentation pages are not being updated ? =
many
are outdated.. how can we collaborate?=20
<
http://www.ovirt.org/documentation/admin-guide/> ?
>>=20
>> regards,
>> JP
>> _______________________________________________
>> Users mailing list
>> Users(a)ovirt.org <mailto:Users@ovirt.org>
>>
http://lists.ovirt.org/mailman/listinfo/users =
<
http://lists.ovirt.org/mailman/listinfo/users>
>=20
>=20
> _______________________________________________
> Users mailing list
> Users(a)ovirt.org <mailto:Users@ovirt.org>
>
http://lists.ovirt.org/mailman/listinfo/users =
<
http://lists.ovirt.org/mailman/listinfo/users>
>=20
>=20
> _______________________________________________
> Users mailing list
> Users(a)ovirt.org <mailto:Users@ovirt.org>
>
http://lists.ovirt.org/mailman/listinfo/users =
<
http://lists.ovirt.org/mailman/listinfo/users>
=20
=20
_______________________________________________
Users mailing list
Users(a)ovirt.org <mailto:Users@ovirt.org>
http://lists.ovirt.org/mailman/listinfo/users =
<
http://lists.ovirt.org/mailman/listinfo/users>
=20
=20
_______________________________________________
Users mailing list
Users(a)ovirt.org <mailto:Users@ovirt.org>
http://lists.ovirt.org/mailman/listinfo/users =
<
http://lists.ovirt.org/mailman/listinfo/users>
--Apple-Mail=_6EF264BF-468F-4E40-9226-B2A9C0F8D42C
Content-Transfer-Encoding: quoted-printable
Content-Type: text/html;
charset=utf-8
<html><head><meta http-equiv=3D"Content-Type"
content=3D"text/html =
charset=3Dutf-8"></head><body style=3D"word-wrap: break-word; =
-webkit-nbsp-mode: space; -webkit-line-break: after-white-space;" =
class=3D""><div class=3D"">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=3D""><br =
class=3D""></div><div class=3D"">I'm coding a
python wrapper around the =
sdk4 and fighting a lot with documentation. </div><div
class=3D""><br=
class=3D""></div><div class=3D"">First I tried to
google:</div><div =
class=3D"">ovirt python sdk4</div><div class=3D"">ovirt
python sdk =
4</div><div class=3D"">ovirt rest api 4</div><div
class=3D""><br =
class=3D""></div><div class=3D"">I was finally given
<a =
href=3D"http://ovirt.github.io/ovirt-engine-sdk/master" =
class=3D"">http://ovirt.github.io/ovirt-engine-sdk/master</a>, but
<a =
href=3D"http://ovirt.github.io"
class=3D"">http://ovirt.github.io</a> =
returns a 404, the sdk is hidden under <a =
href=3D"http://ovirt.github.io/ovirt-engine-sdk/" =
class=3D"">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=3D"http://ovirt.github.io/ovirt-engine-sdk/master/version.m.html" =
class=3D"">http://ovirt.github.io/ovirt-engine-sdk/master/version.m.html</=
a>, how do you go to the first page ?</div><div class=3D""><br
=
class=3D""></div><div class=3D"">If I try to gogle the
title of this =
page, I found <a =
href=3D"http://www.ovirt.org/develop/release-management/features/inf...
hon-sdk/" =
class=3D"">http://www.ovirt.org/develop/release-management/f...
python-sdk/</a> as first result and it's even not in the first page of =
results .</div><div class=3D""><br
class=3D""></div><div class=3D"">Or =
you can have a look at <a =
href=3D"https://access.redhat.com/documentation/en-us/red_hat_virtua...
on/4.1/html-single/python_sdk_guide/" =
class=3D"">https://access.redhat.com/documentation/en-us/red...
ation/4.1/html-single/python_sdk_guide/</a>, that talks only about v3 =
sdk, which is deprecated.</div><div class=3D""><br
class=3D""></div><div =
class=3D"">The python sdk change log:</div><div
class=3D""><a =
href=3D"http://www.ovirt.org/develop/sdk/python-sdk-changelog/" =
class=3D"">http://www.ovirt.org/develop/sdk/python-sdk-chang...
<div class=3D""><br
class=3D""></div><div class=3D"">At pypi, no links =
to the sdk documentation</div><div class=3D""><a =
href=3D"https://pypi.python.org/pypi/ovirt-engine-sdk-python" =
class=3D"">https://pypi.python.org/pypi/ovirt-engine-sdk-pyt...
div class=3D""><br class=3D""></div><div
class=3D"">I requested the =
events codes, I was given that:</div><div class=3D""><a =
href=3D"https://github.com/oVirt/ovirt-engine/blob/master/backend/ma...
modules/common/src/main/java/org/ovirt/engine/core/common/AuditLogType.jav=
a#L726" =
class=3D"">https://github.com/oVirt/ovirt-engine/blob/master...
er/modules/common/src/main/java/org/ovirt/engine/core/common/AuditLogType.=
java#L726</a></div><div class=3D""><br
class=3D""></div><div class=3D"">Is=
there a formal list somewhere ?</div><div class=3D""><br =
class=3D""></div><div
class=3D""><div><blockquote type=3D"cite" =
class=3D""><div class=3D"">Le 10 mai 2017 =C3=A0 08:21, Oved
Ourfali =
<<a href=3D"mailto:oourfali@redhat.com" =
class=3D"">oourfali(a)redhat.com</a>&gt; a =C3=A9crit
:</div><br =
class=3D"Apple-interchange-newline"><div class=3D""><div
dir=3D"ltr" =
style=3D"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=3D""><div
class=3D"gmail_extra"><br=
class=3D"Apple-interchange-newline"><br class=3D""><div
=
class=3D"gmail_quote">On Tue, May 9, 2017 at 11:46 PM, Fabrice =
Bacchella<span
class=3D"Apple-converted-space"> </span><span =
dir=3D"ltr" class=3D""><<a
href=3D"mailto:fabrice.bacchella@orange.fr" =
target=3D"_blank" =
class=3D"">fabrice.bacchella(a)orange.fr</a>&gt;</span><span
=
class=3D"Apple-converted-space"> </span>wrote:<br =
class=3D""><blockquote class=3D"gmail_quote"
style=3D"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=3D"word-wrap: break-word;" class=3D"">I'm whining because
ovirt is =
a wonderful product, peoples behind are nice, but ho boy, what about the =
execution !<div class=3D""><br
class=3D""></div></div></blockquote><div =
class=3D""><br class=3D""></div><div
class=3D"">I couldn't agree more =
with James here.</div><div class=3D"">It is good to whine, complain,
and =
seek for improvements. We all want a better project!</div><div =
class=3D"">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=3D"">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=3D"">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=3D""><br
class=3D""></div><div class=3D"">Oved<br=
class=3D""></div><div
class=3D""> </div><div
class=3D"">[1] <a =
href=3D"https://www.ovirt.org/community/about/community-guidelines/&... =
class=3D"">https://www.ovirt.org/community/about/community-g...
</div><div class=3D""><br
class=3D""></div><blockquote =
class=3D"gmail_quote" style=3D"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=3D"word-wrap: =
break-word;" class=3D""><div
class=3D""></div><div class=3D"">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=3D""><div
class=3D"gmail-h5"><div =
class=3D""><br class=3D""><div
class=3D""><blockquote type=3D"cite" =
class=3D""><div class=3D"">Le 9 mai 2017 =C3=A0 22:28, James
Michels =
<<a href=3D"mailto:karma.sometimes.hurts@gmail.com"
target=3D"_blank" =
class=3D"">karma.sometimes.hurts(a)gmail.<wbr
class=3D"">com</a>> a =
=C3=A9crit :</div><br =
class=3D"gmail-m_5139079229713401712Apple-interchange-newline"><div =
class=3D""><div dir=3D"ltr" class=3D"">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=3D""><br class=3D""></div><div
class=3D"">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=3D""><br
class=3D""></div><div class=3D"">James<br =
class=3D""><div class=3D"gmail_extra"><br
class=3D""><div =
class=3D"gmail_quote">2017-05-09 15:59 GMT+01:00 Fabrice Bacchella<span =
class=3D"Apple-converted-space"> </span><span
dir=3D"ltr" =
class=3D""><<a
href=3D"mailto:fabrice.bacchella@orange.fr" =
target=3D"_blank" =
class=3D"">fabrice.bacchella@orange.fr</a>></span>:<br
=
class=3D""><blockquote class=3D"gmail_quote"
style=3D"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=3D"word-wrap: break-word;" class=3D"">The documentation is
alway a =
good laugh at ovirt. Look for RHEL instead.<div class=3D""><br =
class=3D""><div class=3D""><blockquote
type=3D"cite" class=3D""><div =
class=3D""><div
class=3D"gmail-m_5139079229713401712h5"><div class=3D"">Le=
9 mai 2017 =C3=A0 16:13, Juan Pablo <<a =
href=3D"mailto:pablo.localhost@gmail.com" target=3D"_blank" =
class=3D"">pablo.localhost(a)gmail.com</a>&gt; a =C3=A9crit
:</div><br =
class=3D"gmail-m_5139079229713401712m_8030520292843597762Apple-interchange=
-newline"></div></div><div class=3D""><div
class=3D""><div =
class=3D"gmail-m_5139079229713401712h5"><div dir=3D"ltr"
class=3D""><div =
class=3D""><div class=3D"">Team, Is just me or the
documentation pages =
are not being updated ? many are outdated.. how can we collaborate?<span =
class=3D"Apple-converted-space"> </span><br
class=3D""><br =
class=3D"">whats up with<span =
class=3D"Apple-converted-space"> </span><a =
href=3D"http://www.ovirt.org/documentation/admin-guide/"
target=3D"_blank"=
class=3D"">http://www.ovirt.org/documenta<wbr =
class=3D"">tion/admin-guide/</a><span =
class=3D"Apple-converted-space"> </span>?<br
class=3D""><br =
class=3D""></div>regards,<br
class=3D""></div>JP<br =
class=3D""></div></div></div>______________________________<wbr
=
class=3D"">_________________<br class=3D"">Users mailing
list<br =
class=3D""><a href=3D"mailto:Users@ovirt.org"
target=3D"_blank" =
class=3D"">Users(a)ovirt.org</a><br class=3D""><a =
href=3D"http://lists.ovirt.org/mailman/listinfo/users"
target=3D"_blank" =
class=3D"">http://lists.ovirt.org/mailman<wbr =
class=3D"">/listinfo/users</a><br
class=3D""></div></blockquote></div><br =
class=3D""></div></div><br
class=3D"">______________________________<wbr =
class=3D"">_________________<br class=3D"">Users mailing
list<br =
class=3D""><a href=3D"mailto:Users@ovirt.org"
target=3D"_blank" =
class=3D"">Users(a)ovirt.org</a><br class=3D""><a =
href=3D"http://lists.ovirt.org/mailman/listinfo/users"
rel=3D"noreferrer" =
target=3D"_blank"
class=3D"">http://lists.ovirt.org/mailman<wbr
=
class=3D"">/listinfo/users</a><br class=3D""><br =
class=3D""></blockquote></div><br =
class=3D""></div></div></div>______________________________<wbr
=
class=3D"">_________________<br class=3D"">Users mailing
list<br =
class=3D""><a href=3D"mailto:Users@ovirt.org"
target=3D"_blank" =
class=3D"">Users(a)ovirt.org</a><br class=3D""><a =
href=3D"http://lists.ovirt.org/mailman/listinfo/users"
target=3D"_blank" =
class=3D"">http://lists.ovirt.org/<wbr =
class=3D"">mailman/listinfo/users</a><br =
class=3D""></div></blockquote></div><br =
class=3D""></div></div></div></div><br =
class=3D"">______________________________<wbr =
class=3D"">_________________<br class=3D"">Users mailing
list<br =
class=3D""><a href=3D"mailto:Users@ovirt.org" =
class=3D"">Users(a)ovirt.org</a><br class=3D""><a =
href=3D"http://lists.ovirt.org/mailman/listinfo/users"
rel=3D"noreferrer" =
target=3D"_blank"
class=3D"">http://lists.ovirt.org/<wbr =
class=3D"">mailman/listinfo/users</a><br
class=3D""><br =
class=3D""></blockquote></div><br
class=3D""></div></div><span =
style=3D"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=3D"">_______________________________________________</span><br
=
style=3D"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=3D""><span
style=3D"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=3D"">Users mailing =
list</span><br style=3D"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=3D""><a =
href=3D"mailto:Users@ovirt.org" style=3D"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=3D"">Users(a)ovirt.org</a><br style=3D"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=3D""><a
href=3D"http://lists.ovirt.org/mailman/listinfo/users" =
style=3D"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=3D"">http://lists.ovirt.org/mailman/listinfo/users<...
uote></div><br
class=3D""></div></body></html>=
--Apple-Mail=_6EF264BF-468F-4E40-9226-B2A9C0F8D42C--