do we need some documentation mainteiners?

Team, Is just me or the documentation pages are not being updated ? many are outdated.. how can we collaborate? whats up with http://www.ovirt.org/documentation/admin-guide/ ? regards, JP

--Apple-Mail=_5B5D72CA-062C-4886-A1DC-42671034A78A Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 The documentation is alway a good laugh at ovirt. Look for RHEL instead.
Le 9 mai 2017 =C3=A0 16:13, Juan Pablo <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 =20 whats up with http://www.ovirt.org/documentation/admin-guide/ = <http://www.ovirt.org/documentation/admin-guide/> ? =20 regards, JP _______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
--Apple-Mail=_5B5D72CA-062C-4886-A1DC-42671034A78A 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"">The documentation is alway a good laugh at ovirt. Look for = RHEL instead.<div class=3D""><br class=3D""><div><blockquote type=3D"cite"= class=3D""><div class=3D"">Le 9 mai 2017 =C3=A0 16:13, Juan Pablo = <<a href=3D"mailto:pablo.localhost@gmail.com" = class=3D"">pablo.localhost@gmail.com</a>> a =C3=A9crit :</div><br = class=3D"Apple-interchange-newline"><div class=3D""><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? <br class=3D""><br class=3D"">whats up with <a = href=3D"http://www.ovirt.org/documentation/admin-guide/" = class=3D"">http://www.ovirt.org/documentation/admin-guide/</a> ?<br = class=3D""><br class=3D""></div>regards,<br class=3D""></div>JP<br = class=3D""></div> _______________________________________________<br class=3D"">Users = mailing list<br class=3D""><a href=3D"mailto:Users@ovirt.org" = class=3D"">Users@ovirt.org</a><br = class=3D"">http://lists.ovirt.org/mailman/listinfo/users<br = class=3D""></div></blockquote></div><br class=3D""></div></body></html>= --Apple-Mail=_5B5D72CA-062C-4886-A1DC-42671034A78A--

On Tue, May 9, 2017 at 5:59 PM, Fabrice Bacchella < fabrice.bacchella@orange.fr> wrote:
The documentation is alway a good laugh at ovirt. Look for RHEL instead.
After you finish laughing, you could improve it. I have no doubt that you have both the skills as well as the experience and knowledge using oVirt to do so and provide significant value to the community. Y.
Le 9 mai 2017 à 16:13, Juan Pablo <pablo.localhost@gmail.com> a écrit :
Team, Is just me or the documentation pages are not being updated ? many are outdated.. how can we collaborate?
whats up with http://www.ovirt.org/documentation/admin-guide/ ?
regards, JP _______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
_______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users

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. 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. James 2017-05-09 15:59 GMT+01:00 Fabrice Bacchella <fabrice.bacchella@orange.fr>:
The documentation is alway a good laugh at ovirt. Look for RHEL instead.
Le 9 mai 2017 à 16:13, Juan Pablo <pablo.localhost@gmail.com> a écrit :
Team, Is just me or the documentation pages are not being updated ? many are outdated.. how can we collaborate?
whats up with http://www.ovirt.org/documentation/admin-guide/ ?
regards, JP _______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
_______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users

Le 9 mai 2017 =C3=A0 22:28, James Michels = <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 =
--Apple-Mail=_4266210C-FD6D-4D38-8303-6DC5BA47F8E1 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=utf-8 I'm whining because ovirt is a wonderful product, peoples behind are = nice, but ho boy, what about the execution ! 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. 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@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@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 =20 whats up with http://www.ovirt.org/documentation/admin-guide/ = <http://www.ovirt.org/documentation/admin-guide/> ? =20 regards, JP _______________________________________________ Users mailing list Users@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@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@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
--Apple-Mail=_4266210C-FD6D-4D38-8303-6DC5BA47F8E1 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"">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 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""><br class=3D""><div><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" = class=3D"">karma.sometimes.hurts@gmail.com</a>> a =C3=A9crit = :</div><br class=3D"Apple-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 = 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:0 0 0 = .8ex;border-left:1px #ccc solid;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"h5"><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@gmail.com</a>> a =C3=A9cri= t :</div><br = class=3D"m_8030520292843597762Apple-interchange-newline"></div></div><div = class=3D""><div class=3D""><div class=3D"h5"><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? <br class=3D""><br class=3D"">whats up with <a = href=3D"http://www.ovirt.org/documentation/admin-guide/" target=3D"_blank"= class=3D"">http://www.ovirt.org/<wbr = class=3D"">documentation/admin-guide/</a> ?<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@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><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@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></div> _______________________________________________<br class=3D"">Users = mailing list<br class=3D""><a href=3D"mailto:Users@ovirt.org" = class=3D"">Users@ovirt.org</a><br = class=3D"">http://lists.ovirt.org/mailman/listinfo/users<br = class=3D""></div></blockquote></div><br class=3D""></div></body></html>= --Apple-Mail=_4266210C-FD6D-4D38-8303-6DC5BA47F8E1--

On Tue, May 9, 2017 at 11:46 PM, Fabrice Bacchella < 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 !
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. Oved [1] https://www.ovirt.org/community/about/community-guidelines/ 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.
Le 9 mai 2017 à 22:28, James Michels <karma.sometimes.hurts@gmail.com> a écrit :
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.
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.
James
2017-05-09 15:59 GMT+01:00 Fabrice Bacchella <fabrice.bacchella@orange.fr> :
The documentation is alway a good laugh at ovirt. Look for RHEL instead.
Le 9 mai 2017 à 16:13, Juan Pablo <pablo.localhost@gmail.com> a écrit :
Team, Is just me or the documentation pages are not being updated ? many are outdated.. how can we collaborate?
whats up with http://www.ovirt.org/documentation/admin-guide/ ?
regards, JP _______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
_______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
_______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
_______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users

Le 10 mai 2017 =C3=A0 08:21, Oved Ourfali <oourfali@redhat.com> a = =C3=A9crit : =20 =20 =20 On Tue, May 9, 2017 at 11:46 PM, Fabrice Bacchella = <fabrice.bacchella@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. =20 Oved =20 [1] https://www.ovirt.org/community/about/community-guidelines/ = <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@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 =
--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 ? 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@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@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 =20 whats up with http://www.ovirt.org/documentation/admin-guide/ = <http://www.ovirt.org/documentation/admin-guide/> ? =20 regards, JP _______________________________________________ Users mailing list Users@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@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@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@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@ovirt.org <mailto:Users@ovirt.org> http://lists.ovirt.org/mailman/listinfo/users = <http://lists.ovirt.org/mailman/listinfo/users>
<div class=3D""><br class=3D""></div><div class=3D"">At pypi, no links = to the sdk documentation</div><div class=3D""><a =
--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/infra/pyt= hon-sdk/" = class=3D"">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=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_virtualizati= on/4.1/html-single/python_sdk_guide/" = class=3D"">https://access.redhat.com/documentation/en-us/red_hat_virtualiz= 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-changelog/</a></div= href=3D"https://pypi.python.org/pypi/ovirt-engine-sdk-python" = class=3D"">https://pypi.python.org/pypi/ovirt-engine-sdk-python</a></div><= 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/manager/= modules/common/src/main/java/org/ovirt/engine/core/common/AuditLogType.jav= a#L726" = class=3D"">https://github.com/oVirt/ovirt-engine/blob/master/backend/manag= 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@redhat.com</a>> 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@orange.fr</a>></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-guidelines/</a>= </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@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@gmail.com</a>> 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@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@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@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@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@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</a></div></blockq= uote></div><br class=3D""></div></body></html>= --Apple-Mail=_6EF264BF-468F-4E40-9226-B2A9C0F8D42C--

this was not the intention of the thread. so please stop throwing bananas each other. Lets focus on the subject here:do we need some documentation mainteiners? yes/no regards, JP 2017-05-10 5:27 GMT-03:00 Fabrice Bacchella <fabrice.bacchella@orange.fr>:
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.
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/html- 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 à 08:21, Oved Ourfali <oourfali@redhat.com> a écrit :
On Tue, May 9, 2017 at 11:46 PM, Fabrice Bacchella <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 !
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.
Oved
[1] https://www.ovirt.org/community/about/community-guidelines/
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.
Le 9 mai 2017 à 22:28, James Michels <karma.sometimes.hurts@gmail.com> a écrit :
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.
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.
James
2017-05-09 15:59 GMT+01:00 Fabrice Bacchella <fabrice.bacchella@orange.fr
:
The documentation is alway a good laugh at ovirt. Look for RHEL instead.
Le 9 mai 2017 à 16:13, Juan Pablo <pablo.localhost@gmail.com> a écrit :
Team, Is just me or the documentation pages are not being updated ? many are outdated.. how can we collaborate?
whats up with http://www.ovirt.org/documentation/admin-guide/ ?
regards, JP _______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
_______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
_______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
_______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
_______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
_______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users

On 10 May 2017 at 14:18, Juan Pablo <pablo.localhost@gmail.com> wrote:
this was not the intention of the thread. so please stop throwing bananas each other.
Lets focus on the subject here:do we need some documentation mainteiners? yes/no
My answer would be definitely. If you are volunteering, you would be very welcome. -- Barak Korren RHV DevOps team , RHCE, RHCi Red Hat EMEA redhat.com | TRIED. TESTED. TRUSTED. | redhat.com/trusted

I am! =) but Im dizzy on how/where to start. suggestions/ideas are welcome JP El 10/5/2017 12:20, "Barak Korren" <bkorren@redhat.com> escribió:
On 10 May 2017 at 14:18, Juan Pablo <pablo.localhost@gmail.com> wrote:
this was not the intention of the thread. so please stop throwing bananas each other.
Lets focus on the subject here:do we need some documentation mainteiners? yes/no
My answer would be definitely. If you are volunteering, you would be very welcome.
-- Barak Korren RHV DevOps team , RHCE, RHCi Red Hat EMEA redhat.com | TRIED. TESTED. TRUSTED. | redhat.com/trusted

On Wed, May 10, 2017 at 8:07 PM, Juan Pablo <pablo.localhost@gmail.com> wrote:
I am! =) but Im dizzy on how/where to start. suggestions/ideas are welcome
Perhaps start by reading the readme file of the site: https://github.com/oVirt/ovirt-site and continue with "CONTRIBUTING.md" and "MAINTAINING.md" there. If you are new to git/github, you should probably read about them too, although for simply editing the web site the basics should be enough. Feel free to ask any questions - perhaps on devel@ovirt.org instead of here. Welcome and good luck!
JP
El 10/5/2017 12:20, "Barak Korren" <bkorren@redhat.com> escribió:
On 10 May 2017 at 14:18, Juan Pablo <pablo.localhost@gmail.com> wrote:
this was not the intention of the thread. so please stop throwing bananas each other.
Lets focus on the subject here:do we need some documentation mainteiners? yes/no
My answer would be definitely. If you are volunteering, you would be very welcome.
-- Barak Korren RHV DevOps team , RHCE, RHCi Red Hat EMEA redhat.com | TRIED. TESTED. TRUSTED. | redhat.com/trusted
_______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
-- Didi

On Thu, May 11, 2017 at 8:50 AM, Yedidyah Bar David <didi@redhat.com> wrote:
On Wed, May 10, 2017 at 8:07 PM, Juan Pablo <pablo.localhost@gmail.com> wrote:
I am! =) but Im dizzy on how/where to start. suggestions/ideas are welcome
Perhaps start by reading the readme file of the site:
https://github.com/oVirt/ovirt-site
and continue with "CONTRIBUTING.md" and "MAINTAINING.md" there.
If you are new to git/github, you should probably read about them too, although for simply editing the web site the basics should be enough.
Feel free to ask any questions - perhaps on devel@ovirt.org instead of here. Welcome and good luck!
I'd also like to take the opportunity and talk a bit about the content. Many times people here refer to RHV documentation. RHV documentation is indeed very good, but has a few problems, if you consider "simply" copying from there: 1. It's RHV-specific. 99% of times this is irrelevant, but when it is, RHV doc writers do not make any attempt to be oVirt-compatible. Examples: It does not cover at all Fedora-specific issues, it did not cover in the past use of oVirt 3.5 and 3.6 on EL7 (because RHV did not support that). 2. You should study well the legal notices included in the guides there. The licenses for RHV documentation are quite different from the licenses for the oVirt projects' source code. 3. It's written by writers, not developers. This means it's much more organized, more-or-less complete, better written, but still might be out-of-date or inaccurate. 4. It tends to be less detailed about feature internals, about things that might break if you do not follow the doc, about non-standard potential uses, etc. It's mostly intended for people that do things "by the book" :-) It usually does not cover things that Red Hat decided to not support, even if they mostly work. Other sources for content one should consider, both for direct learning and as a source for writing documentation: 1. Mailing list archives. Both users and devel can be useful. 2. Discussions on bugzilla bugs. Many times you can find there the most accurate definition of what a feature does, how to test/use it, and how it was verified. When you do that, check if the bug is on oVirt or on RHV. In the past, the distinction wasn't as accurate and not strictly followed, but in recent versions we try to better make sure that bugs that are opened on RHV and affect also oVirt are moved to oVirt. See also: https://www.ovirt.org/develop/dev-process/bugzilla-rework/ 3. Source code. In some parts it's rather easy to follow if you have any experience dealing with source code, and in others you can at least read the comments. This applies even if you never _wrote_ a single line of source code in any programming language. when you decide to have a look at the source code, you should do this by cloning the git projects, not by downloading the tarballs or SRPMs. This way you win on two fronts: a. You get at once the entire project history including all its versions, in a single place. b. You can then also search the git history and find out when something was changed, comments about the change, etc. 4. gerrit. gerrit is our review tool, and all patches for the projects maintained there go through it. This in many cases includes long discussions between developers about what the patch actually should do and how it should do that. In some cases you can also see there how a patch was verified to do what it's supposed to do. Sadly, gerrit review history isn't as easy to search as the other sources above. Perhaps we should do something to make it easier as well.
JP
El 10/5/2017 12:20, "Barak Korren" <bkorren@redhat.com> escribió:
On 10 May 2017 at 14:18, Juan Pablo <pablo.localhost@gmail.com> wrote:
this was not the intention of the thread. so please stop throwing bananas each other.
Lets focus on the subject here:do we need some documentation mainteiners? yes/no
My answer would be definitely. If you are volunteering, you would be very welcome.
-- Barak Korren RHV DevOps team , RHCE, RHCi Red Hat EMEA redhat.com | TRIED. TESTED. TRUSTED. | redhat.com/trusted
_______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
-- Didi
-- Didi

On 9 May 2017 at 17:13, Juan Pablo <pablo.localhost@gmail.com> wrote:
Team, Is just me or the documentation pages are not being updated ? many are outdated.. how can we collaborate?
Head over to GitHub: https://github.com/oVirt/ovirt-site
whats up with http://www.ovirt.org/documentation/admin-guide/ ?
Looks like a bad link on the site. There seems to be an administration guide here: http://www.ovirt.org/documentation/admin-guide/administration-guide/ -- Barak Korren RHV DevOps team , RHCE, RHCi Red Hat EMEA redhat.com | TRIED. TESTED. TRUSTED. | redhat.com/trusted

I've actually got the page up in Github and was about to make the quick edit to "fix it", but the proper administration guide link is already under "Primary Documentation". Then I noticed the link under "Additional Documentation" appears to be a catch all for all directories/pages under the admin guide directory, with the other links under "Additional Documentation" being similar. (and yes, that isn't working right as Juan pointed out). It looks like the Additional Documentation links are a "Works as designed" more or less, but could definitely use some cleaning up in general? I'd proceed as it looks like a quick cleanup, but I'm uncertain on design considerations here and the intent of the structure. :) Cheers, Jeff On Tue, May 9, 2017 at 10:20 AM, Barak Korren <bkorren@redhat.com> wrote:
On 9 May 2017 at 17:13, Juan Pablo <pablo.localhost@gmail.com> wrote:
Team, Is just me or the documentation pages are not being updated ? many are outdated.. how can we collaborate?
Head over to GitHub: https://github.com/oVirt/ovirt-site
whats up with http://www.ovirt.org/documentation/admin-guide/ ?
Looks like a bad link on the site. There seems to be an administration guide here: http://www.ovirt.org/documentation/admin-guide/administration-guide/
-- Barak Korren RHV DevOps team , RHCE, RHCi Red Hat EMEA redhat.com | TRIED. TESTED. TRUSTED. | redhat.com/trusted _______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users

what do you guys think on having a pdf/ html in the main upper canvas "guide" button instead of pointing to http://www.ovirt.org/documentation/? so that way everyone has the correct information for the correct version regards, 2017-05-09 14:04 GMT-03:00 Jeff Burns <admiraljkb@gmail.com>:
I've actually got the page up in Github and was about to make the quick edit to "fix it", but the proper administration guide link is already under "Primary Documentation". Then I noticed the link under "Additional Documentation" appears to be a catch all for all directories/pages under the admin guide directory, with the other links under "Additional Documentation" being similar. (and yes, that isn't working right as Juan pointed out). It looks like the Additional Documentation links are a "Works as designed" more or less, but could definitely use some cleaning up in general? I'd proceed as it looks like a quick cleanup, but I'm uncertain on design considerations here and the intent of the structure. :)
Cheers, Jeff
On Tue, May 9, 2017 at 10:20 AM, Barak Korren <bkorren@redhat.com> wrote:
On 9 May 2017 at 17:13, Juan Pablo <pablo.localhost@gmail.com> wrote:
Team, Is just me or the documentation pages are not being updated ? many are outdated.. how can we collaborate?
Head over to GitHub: https://github.com/oVirt/ovirt-site
whats up with http://www.ovirt.org/documentation/admin-guide/ ?
Looks like a bad link on the site. There seems to be an administration guide here: http://www.ovirt.org/documentation/admin-guide/administration-guide/
-- Barak Korren RHV DevOps team , RHCE, RHCi Red Hat EMEA redhat.com | TRIED. TESTED. TRUSTED. | redhat.com/trusted _______________________________________________ Users mailing list Users@ovirt.org http://lists.ovirt.org/mailman/listinfo/users
participants (8)
-
Barak Korren
-
Fabrice Bacchella
-
James Michels
-
Jeff Burns
-
Juan Pablo
-
Oved Ourfali
-
Yaniv Kaul
-
Yedidyah Bar David