Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds

2012-12-04 Thread Rick Zero_Chaos Farina
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 12/02/2012 10:21 AM, hasufell wrote:
 As I was told in my recruiting process we usually don't just fix up
 ebuilds of other devs unless it's trivial, very severe or something.
 
 The usual process is nothing new: try to contact the maintainer, open a
 bug, set a deadline when you will go and fix yourself.
 
 Only question is now what is a sane soft limit, before you go on and fix
 stuff.
From a discussion in #gentoo-dev we thought 2-4 weeks depending on the
 severity of the bug is fine. Ofc this should exclude major changes or
 delicate packages from base-system/core/toolchain.
 
 I tried to document that a bit:
 https://bugs.gentoo.org/show_bug.cgi?id=445402
 
 any objections? This is nothing new, just a clarification of already
 existing policy and a reminder.
 
 
If we are going to document this policy and make it official (which
since it's not documented it's not official) then it only makes sense to
have an opt-out option.  I personally don't wish to see my users suffer
for 2-4 weeks because I'm busy and people are pretending to be polite.

I have no issue with this policy, but to do it without an explicit
option to opt-out is not acceptable to me.  I would suggest something in
the metadata.xml under the maintainer section.  We could have a specific
maintainer section : maintainernamehelp welcome/name/maintainer
or a specific tag to put under our own maintainer section
maintainernameRick Farina/namedemeanorjust fix it/demeanor/name

I currently, and will continue to maintain a completely open policy on
my packages. To write in the rules that this is not acceptable would be
more than rude.

Thanks,
Zero

PS I don't actually mean for either of those suggestions to be used
mind you, it's just an example.
-BEGIN PGP SIGNATURE-
Version: GnuPG v2.0.19 (GNU/Linux)
Comment: Using GnuPG with undefined - http://www.enigmail.net/

iQIcBAEBAgAGBQJQva/iAAoJEKXdFCfdEflKFkwP/jBl4I1qFtTPFh52FfBJF7yX
h4fQSisiYYFitwzWDVoxjkAbKdfdSTxmevkJfRUfIz7AG+8rBjrndHJscwQQXCCm
3533r5B0ql6cXI38pb7WSJdc6xplXx1NVTsPFwxn7rmJVKddFPfa8nOv1dUfjjFN
16Yc6B2oV9rfb0AkaUdnAYNJLgjP5gL7AXIJoScUcPVXJZ/glWp/ADmlN+sKsKoy
bOBe1Hbm2Z5tTNPun4zOqKtb34daBbLjbtYHz4fR2r+MdbgHQKUIdO1z8iBE6+fR
/cOCbN+64jG7Yz3G1n+6rXfFBocRjkin8fEk4hXaZ7FkHOa5w7ONRNFvqmQ+BBfa
4SlI/scZ6lEDMi4GDFMdX/ShdaptXvHYcaJIKyE//EP6Q40Ijtqe2HUv1eUjbR5V
/HfTapF8YnxX6NZwQPTihpMv3TCneTbKH3anHuWLR3wK0SAMraP6zqYIImfPG0Pt
ePm+dRQ6ocZIoDuGroYX9gInqLRqeI+2EWFLMvN3VkDq358N1tX5PhGfTw6AUCw7
ao3iZkE3n49xywSYzDAsschoV7iWoJfBdSYbcqRcok/3Z1sEBRd6P2wc6NMFJbO3
rWpCDj3vrg08Up6CJIgAsh4r3e5McAcvwycTcWEaDCDgRujjcJN6iN5JR4zur5AK
JNc0sFc3rrPHo4Pyu079
=ZBY6
-END PGP SIGNATURE-



Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds

2012-12-04 Thread Markos Chandras
On 4 December 2012 01:18, Ben de Groot yng...@gentoo.org wrote:
 On 3 December 2012 03:30, Markos Chandras hwoar...@gentoo.org wrote:


 On Dec 2, 2012 6:09 PM, Rich Freeman ri...@gentoo.org wrote:
 
  On Sun, Dec 2, 2012 at 10:21 AM, hasufell hasuf...@gentoo.org wrote:
   Only question is now what is a sane soft limit, before you go on and
   fix
   stuff.
   From a discussion in #gentoo-dev we thought 2-4 weeks depending on the
   severity of the bug is fine. Ofc this should exclude major changes or
   delicate packages from base-system/core/toolchain.
 
  Seems reasonable - I'd say 2 weeks is plenty.  Of course, if the
  maintainer explicitly rejects the change in a posting on the bug, then
  it is hands off without some kind of escalation.  Non-maintainers who
  are concerned about a package can always step up to maintain, as long
  as it involves real commitment.
 
  Oh, and on a side note Markos raises a valid point on the bug about
  whether the devmanual is a good place for policy.  The problem is that
  I'm not sure we really have a good place, especially with the ebuild
  docs gone in favor of the devmanual now.
 
  Rich
 

 Maybe adding some bits here[1] is preferred instead of the devmanual.
 Unless we agree to make devmanual a technical and non-technical document,
 which I personally don't like because it will end up being huge without some
 sort of indexing/search textbox for quick queries.

 [1]
 http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2chap=2


 In my opinion we should limit the amount of places where we document
 policies and best practices. I suggest we keep only devmanual and PMS as
 authoritative documents.

 In that case we should go forward and add these kind of policies to the
 devmanual.

 --
 Cheers,

 Ben | yngwin
 Gentoo developer
 Gentoo Qt project lead, Gentoo Wiki admin

As I said, the only drawback is that devmanual will become huge and
without a proper search functionality, it will be a real pain to
search
for something quickly. Especially for new developers who are not
familiar with how devmanual is structured.

-- 
Regards,
Markos Chandras / Gentoo Linux Developer / Key ID: B4AFF2C2



Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds

2012-12-04 Thread Markos Chandras
On 4 December 2012 08:10, Rick Zero_Chaos Farina zeroch...@gentoo.org wrote:
 -BEGIN PGP SIGNED MESSAGE-
 Hash: SHA1

 On 12/02/2012 10:21 AM, hasufell wrote:
 As I was told in my recruiting process we usually don't just fix up
 ebuilds of other devs unless it's trivial, very severe or something.

 The usual process is nothing new: try to contact the maintainer, open a
 bug, set a deadline when you will go and fix yourself.

 Only question is now what is a sane soft limit, before you go on and fix
 stuff.
From a discussion in #gentoo-dev we thought 2-4 weeks depending on the
 severity of the bug is fine. Ofc this should exclude major changes or
 delicate packages from base-system/core/toolchain.

 I tried to document that a bit:
 https://bugs.gentoo.org/show_bug.cgi?id=445402

 any objections? This is nothing new, just a clarification of already
 existing policy and a reminder.


 If we are going to document this policy and make it official (which
 since it's not documented it's not official) then it only makes sense to
 have an opt-out option.  I personally don't wish to see my users suffer
 for 2-4 weeks because I'm busy and people are pretending to be polite.

 I have no issue with this policy, but to do it without an explicit
 option to opt-out is not acceptable to me.  I would suggest something in
 the metadata.xml under the maintainer section.  We could have a specific
 maintainer section : maintainernamehelp welcome/name/maintainer
 or a specific tag to put under our own maintainer section
 maintainernameRick Farina/namedemeanorjust fix it/demeanor/name

Nobody said the opposite. The devaway message should always be checked
for people who appear to be inactive and if they
say Do not touch my packages then you shouldn't touch them even if
he doesn't even touch them himself. Let the retirement team
kick him out.

There is always the description tag  on metadata.xml you can use eg

maintainer
emailf...@gentoo.org/email
nameMe/name
descriptionPrimary maintainer but feel free to fix the bugsdescription
/maintainer

-- 
Regards,
Markos Chandras / Gentoo Linux Developer / Key ID: B4AFF2C2



Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds

2012-12-04 Thread Alec Warner
On Tue, Dec 4, 2012 at 1:19 AM, Markos Chandras hwoar...@gentoo.org wrote:
 On 4 December 2012 01:18, Ben de Groot yng...@gentoo.org wrote:
 On 3 December 2012 03:30, Markos Chandras hwoar...@gentoo.org wrote:


 On Dec 2, 2012 6:09 PM, Rich Freeman ri...@gentoo.org wrote:
 
  On Sun, Dec 2, 2012 at 10:21 AM, hasufell hasuf...@gentoo.org wrote:
   Only question is now what is a sane soft limit, before you go on and
   fix
   stuff.
   From a discussion in #gentoo-dev we thought 2-4 weeks depending on the
   severity of the bug is fine. Ofc this should exclude major changes or
   delicate packages from base-system/core/toolchain.
 
  Seems reasonable - I'd say 2 weeks is plenty.  Of course, if the
  maintainer explicitly rejects the change in a posting on the bug, then
  it is hands off without some kind of escalation.  Non-maintainers who
  are concerned about a package can always step up to maintain, as long
  as it involves real commitment.
 
  Oh, and on a side note Markos raises a valid point on the bug about
  whether the devmanual is a good place for policy.  The problem is that
  I'm not sure we really have a good place, especially with the ebuild
  docs gone in favor of the devmanual now.
 
  Rich
 

 Maybe adding some bits here[1] is preferred instead of the devmanual.
 Unless we agree to make devmanual a technical and non-technical document,
 which I personally don't like because it will end up being huge without some
 sort of indexing/search textbox for quick queries.

 [1]
 http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2chap=2


 In my opinion we should limit the amount of places where we document
 policies and best practices. I suggest we keep only devmanual and PMS as
 authoritative documents.

 In that case we should go forward and add these kind of policies to the
 devmanual.

 --
 Cheers,

 Ben | yngwin
 Gentoo developer
 Gentoo Qt project lead, Gentoo Wiki admin

 As I said, the only drawback is that devmanual will become huge and
 without a proper search functionality, it will be a real pain to
 search
 for something quickly. Especially for new developers who are not
 familiar with how devmanual is structured.

site:devmanual.gentoo.org term

Works in bing, I tried it!
It likely works in any modern search engine.


 --
 Regards,
 Markos Chandras / Gentoo Linux Developer / Key ID: B4AFF2C2




Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds

2012-12-04 Thread Rick Zero_Chaos Farina
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 12/04/2012 04:23 AM, Markos Chandras wrote:
 On 4 December 2012 08:10, Rick Zero_Chaos Farina zeroch...@gentoo.org 
 wrote:
 -BEGIN PGP SIGNED MESSAGE-
 Hash: SHA1

 On 12/02/2012 10:21 AM, hasufell wrote:
 As I was told in my recruiting process we usually don't just fix up
 ebuilds of other devs unless it's trivial, very severe or something.

 The usual process is nothing new: try to contact the maintainer, open a
 bug, set a deadline when you will go and fix yourself.

 Only question is now what is a sane soft limit, before you go on and fix
 stuff.
 From a discussion in #gentoo-dev we thought 2-4 weeks depending on the
 severity of the bug is fine. Ofc this should exclude major changes or
 delicate packages from base-system/core/toolchain.

 I tried to document that a bit:
 https://bugs.gentoo.org/show_bug.cgi?id=445402

 any objections? This is nothing new, just a clarification of already
 existing policy and a reminder.


 If we are going to document this policy and make it official (which
 since it's not documented it's not official) then it only makes sense to
 have an opt-out option.  I personally don't wish to see my users suffer
 for 2-4 weeks because I'm busy and people are pretending to be polite.

 I have no issue with this policy, but to do it without an explicit
 option to opt-out is not acceptable to me.  I would suggest something in
 the metadata.xml under the maintainer section.  We could have a specific
 maintainer section : maintainernamehelp welcome/name/maintainer
 or a specific tag to put under our own maintainer section
 maintainernameRick Farina/namedemeanorjust fix it/demeanor/name
 
 Nobody said the opposite. The devaway message should always be checked
 for people who appear to be inactive and if they
 say Do not touch my packages then you shouldn't touch them even if
 he doesn't even touch them himself. Let the retirement team
 kick him out.
 
 There is always the description tag  on metadata.xml you can use eg
 
 maintainer
 emailf...@gentoo.org/email
 nameMe/name
 descriptionPrimary maintainer but feel free to fix the bugsdescription
 /maintainer
 
maintainer
emailf...@gentoo.org/email
nameMe/name
descriptionProxy maintainer, assign bugs to proxied maintainer, cc on
bugs, but feel free to just fix the bugsdescription
/maintainer

I feel the description field is already overloaded when there is a proxy
situation, maybe it would be best to define a field for this.  Also
english isn't primary language for everyone in the world so if the
policy could actually be specific on this it would benefit everyone.

- -Zero
-BEGIN PGP SIGNATURE-
Version: GnuPG v2.0.19 (GNU/Linux)
Comment: Using GnuPG with undefined - http://www.enigmail.net/

iQIcBAEBAgAGBQJQvh4+AAoJEKXdFCfdEflKbp8P/2x+DGuDTlLv1ZKJjTQn1zpy
nf6izcfmYcoqaGTIgL5ynFaGmv/H3U6LX42G/kL041bqUn9SjozM+liU+k0RzrQ1
SQcJUPs1tc4qzp+loWnXZnPDWmUJLkRI7n1B/O9SnvEl1g1LxXKmc2j9w51kYWmz
9Lowv3/CKGhWjow5A05DEzNya7bShjm/9tJulXltIL7H0IeC0cZGJeB5/cD7+Qfz
TwugXiGNIWp0gErBUDa9wYdgzI2Z8LEc8IrQhUQS+56IF/ZNcwYP0zJi1S7YEYAs
YVtCMPrUt/JmMKDluDlxQ9JXJ3YZkbz7Eb/iwAXFHlJYNWkf9hjWtQfDmzETx7xu
wqNKF9m1IpoQANgsZRgsKdyAG56ELUW7QtfFNbVTYy0LGu36yZ2Hc3zbZNMvjZhP
T8GYIF/5My89gNdBonHuZ7ub0zP1NpTFWI3qrNdzgI5Ko+aaH75y1Hz+puCwlHOG
Ht0HbhpqRYidos2NSppecGhl9p5oZ8xZI/rVh/BgjtonJrXlIEfYzhUQHU4SzIxt
v0hVJTIXq1RwE7gF4OGLEbpGTM5V0BcdT+FzSRuq5bJiAEvDLXIixdMh5kga6t7F
e9H0iM5aRl9pxO1Rs0bOJmZhoZ+vwyOs/aPLYDNmNx8aNLicIWqfs2aGgjK7G8Y+
QYrB3h0du6gZymOZ+oys
=IpQP
-END PGP SIGNATURE-



Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds

2012-12-04 Thread hasufell
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 12/04/2012 05:01 PM, Rick Zero_Chaos Farina wrote:
 
 maintainer emailf...@gentoo.org/email nameMe/name 
 descriptionProxy maintainer, assign bugs to proxied maintainer,
 cc on bugs, but feel free to just fix the bugsdescription 
 /maintainer
 
 I feel the description field is already overloaded when there is a
 proxy situation, maybe it would be best to define a field for this.
 Also english isn't primary language for everyone in the world so if
 the policy could actually be specific on this it would benefit
 everyone.
 

Please start a new thread, this is unrelated to introducing a _global_
policy on that issue.


On 12/04/2012 09:10 AM, Rick Zero_Chaos Farina wrote:
 
 If we are going to document this policy and make it official
 (which since it's not documented it's not official) then it only
 makes sense to have an opt-out option.  I personally don't wish to
 see my users suffer for 2-4 weeks because I'm busy and people are
 pretending to be polite.
 
 I have no issue with this policy, but to do it without an explicit 
 option to opt-out is not acceptable to me.

This certainly depends on the severity of the bug. If you think my
text can be improved please provide a new patch or tell me what
exactly you would describe differently.

The vague character of this policy is a bit on purpose, otherwise you
would have to describe every possible case. That's not what I want here.
-BEGIN PGP SIGNATURE-
Version: GnuPG v2.0.19 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org/

iQEcBAEBAgAGBQJQvixWAAoJEFpvPKfnPDWzigwH/RtjCwIncSB0DREo6rJhV+aV
MitPqMpR1N+2GAcNs/Bmt9ocWyw2p2mWoPagAlffp6VAoCCg4ocr6xEEsRJUT0ai
xsIBBPC+t+B08GtxdFhv8dWLUrPsVt0N4YwcQ7JmYE8YjDYr6vVxSOBMqmnjX98i
Lsls2QgIdadhsQmPkaz/H5lxTPyxeesCNgsWOejvpJMNFpN6jqcpaMb1jwiqJF9g
aYpU3LMniHeK92RXBv8t/uyYzRaoYLLEzPqXSXGFgxQ0CXsIF9Ub/230n9xCMHG4
+ep3zLl4VsyZcPkwkatwypfHvBRyBNFP3Kv4Ey0q5ipzNxEbAryfRaPqgOqX4Ds=
=eSK5
-END PGP SIGNATURE-



Proxy maintainers in metadata.xml (was Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds)

2012-12-04 Thread Diego Elio Pettenò
On 04/12/2012 08:01, Rick Zero_Chaos Farina wrote:
 I feel the description field is already overloaded when there is a proxy
 situation, maybe it would be best to define a field for this.  Also
 english isn't primary language for everyone in the world so if the
 policy could actually be specific on this it would benefit everyone.

Or maybe we can just agree that common sense rules all, and we always
set the proxied maintainer as assignee, and the proxy maintainer as CC..
because, you know, that's the only way a proxy maintainer can
close/change a bug at all.

-- 
Diego Elio Pettenò — Flameeyes
flamee...@flameeyes.eu — http://blog.flameeyes.eu/



signature.asc
Description: OpenPGP digital signature


Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds

2012-12-04 Thread Rick Zero_Chaos Farina
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 12/04/2012 12:01 PM, hasufell wrote:
 On 12/04/2012 05:01 PM, Rick Zero_Chaos Farina wrote:
 
 maintainer emailf...@gentoo.org/email nameMe/name 
 descriptionProxy maintainer, assign bugs to proxied maintainer,
 cc on bugs, but feel free to just fix the bugsdescription 
 /maintainer
 
 I feel the description field is already overloaded when there is a
 proxy situation, maybe it would be best to define a field for this.
 Also english isn't primary language for everyone in the world so if
 the policy could actually be specific on this it would benefit
 everyone.
 
 
 Please start a new thread, this is unrelated to introducing a _global_
 policy on that issue.

I'm sorry but isn't specific policy related to global policy? Why yes,
yes it is.
 
 
 On 12/04/2012 09:10 AM, Rick Zero_Chaos Farina wrote:
 
 If we are going to document this policy and make it official
 (which since it's not documented it's not official) then it only
 makes sense to have an opt-out option.  I personally don't wish to
 see my users suffer for 2-4 weeks because I'm busy and people are
 pretending to be polite.
 
 I have no issue with this policy, but to do it without an explicit 
 option to opt-out is not acceptable to me.
 
 This certainly depends on the severity of the bug. If you think my
 text can be improved please provide a new patch or tell me what
 exactly you would describe differently.

A patch against what? I've not seen a link, only vague references to the
dev manual.
 
 The vague character of this policy is a bit on purpose, otherwise you
 would have to describe every possible case. That's not what I want here.
 
If we are vaguely defining a policy of not touching other peoples
packages then the only specific thing in that policy should be what is
exempt (which would be if xyz is in the metadata.xml then follow those
instructions over this policy).

This is VERY much on topic.  I am really unhappy that people are writing
policy that will get me less help and more work, and I won't be happy
until I have a way to tell others that in the metadata.xml and the
policy you are writing refers to it.

- -Zero
-BEGIN PGP SIGNATURE-
Version: GnuPG v2.0.19 (GNU/Linux)
Comment: Using GnuPG with undefined - http://www.enigmail.net/

iQIcBAEBAgAGBQJQvjAQAAoJEKXdFCfdEflK0hoP/2IdAy65cH1ZQQo0riNthZJu
vCkz0xmW6RB3woJDBy3Z98sbr/b1SLp7iBJ4EL11/CTj7HPtgTRrJc4lsTAXVMto
TZDOV8IMAY8nK8Xscf3Lm3mmSF36741KyM/T48VyLZ5byy5Awr12DDCXaO3usL0a
fexcwHtNLA5HEyhcvYNNfFNprBTU4CHRxusb/xJxy/sHGffeeE58blXqcFR4qbL6
8N0Kl7E2uu8hZ+w6IbByDyqSsDK5dA8O9ybDBeObzoqOe7hZiP4Q9BDZbmYz9q3+
VPMeU9NeUozrVbPkNBFjuJbd9tD+NABop9QZzJhJJgdoCoLrZDtuzaCNBl86cazW
64gWJmmnrLWKh5ZnYKwSHbAET+2Ua5jyF2E7PEnB/vn2urvyaCSmprU33O20yzma
y6yyvwj89YVk+pEs2oaRUL3ePon8CCQ75vFW1musz6ga/hdAk+O5JXPugIPK6eQT
vLmOPgoskU/rKmzGaztlQtMkRiCRSDta3xy6+/8QKL2vFh+Knyj6uSws7UJjUeIl
eqEts3jzETHnObmQbNGhuwH9iNE9RcxpMki/sS2ziAS5TixQZoY2S6rYbwlA9659
X+bYvRkceImy4XS9MOyaFyfMAnYrIraxXcg6t1u/uXKDDsEKAgGxuVZ/G4Cb8XND
BjfMVk7KiAfhwLRm4PPH
=EEh9
-END PGP SIGNATURE-



Re: Proxy maintainers in metadata.xml (was Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds)

2012-12-04 Thread Rick Zero_Chaos Farina
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 12/04/2012 12:06 PM, Diego Elio Pettenò wrote:
 On 04/12/2012 08:01, Rick Zero_Chaos Farina wrote:
 I feel the description field is already overloaded when there is a proxy
 situation, maybe it would be best to define a field for this.  Also
 english isn't primary language for everyone in the world so if the
 policy could actually be specific on this it would benefit everyone.
 
 Or maybe we can just agree that common sense rules all, and we always
 set the proxied maintainer as assignee, and the proxy maintainer as CC..
 because, you know, that's the only way a proxy maintainer can
 close/change a bug at all.
 
That is a very good point. But being that it's a very good point it
obviously never occurred to me that it shouldn't be spelled out in the
metadata. Is there a policy for this as well that I am unaware of? A
quick site:devmanual.gentoo.org proxy search indicates no
documentation of this at all.

http://www.gentoo.org/proj/en/qa/proxy-maintainers/index.xml?style=printable

This page exists, but doesn't really mention anything about proper bug
assignment. I know a lot of you have been doing this a very long time
and there is a 'standard' way of doing things, but for us new guys if
there is no documentation there is no policy.

- -Zero
-BEGIN PGP SIGNATURE-
Version: GnuPG v2.0.19 (GNU/Linux)
Comment: Using GnuPG with undefined - http://www.enigmail.net/

iQIcBAEBAgAGBQJQvjK5AAoJEKXdFCfdEflKQIUQALGbqDUONaKpQk4xLYDXDTQE
gC7x7MMEyyBveZ3F2aZc/9IvWAzGYU0rQg7qOeEY8v6CLEDsNvi1mOQinhTNaJiv
wnnk6NbnFrDEtBx5/J/3HDoR1PMFaCsAXM6Gd4vfMbtLYH3093COS5IyvBNP4oFB
3FQ+/kBZo9xN3TCpqxBCIjSZoR8aqxd4U6Px4o8KEKrDAkR9czyPRnqRAYb85ch1
qW37YOB2/MrYt1qDNo7m9NIQwmHVnThjkTqR/dzwxAEN7OEpo3MOXi0BX9CKb/kg
1Gp0XDE8iKzb3grnECZ+og4oyBWwZ9ydtGHOW7Vqa85CB2Zk2CkDPAq7RctYlS0t
ItzBhSCDzuRjm3Y5J5jBrz0WaIMKfMQHqJR5ETXDnZmQIN39EqKb+oZYe1ei5hIJ
LmX3zvjF9DVquC/JUQ2yeS/0m2YmF7G56dlE8OII7PlechpYb6pCyPoGttPcuI51
vUy+es8Ib8a2wqFHgpbmcbT37fJ/UVI0FgEuR6YV3ZH+uRwHcpLC8T7cIaTtI59Q
mwIbFOu1+7JlNzJ3kEwZvY1ySuji8t8HbnBAWg6ehhaySbzijywlQtJCkyoUC+1I
AMYkR085XWtomDss113E/c/cJqdn4UzzYR3C6gSyVf1iDqd4XgaG3AR2BGzKAiGr
/J5yITUtwA99CNEpz6d8
=IukP
-END PGP SIGNATURE-



Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds

2012-12-04 Thread Rick Zero_Chaos Farina
-BEGIN PGP SIGNED MESSAGE-
Hash: SHA1

On 12/04/2012 12:32 PM, hasufell wrote:
 On 12/04/2012 06:17 PM, Rick Zero_Chaos Farina wrote:
 
 I'm sorry but isn't specific policy related to global policy? Why
 yes, yes it is.
 
 
 Unless they conflict, then no.
 
 
 On 12/04/2012 09:10 AM, Rick Zero_Chaos Farina wrote:
 
 If we are going to document this policy and make it official 
 (which since it's not documented it's not official) then it
 only makes sense to have an opt-out option.  I personally don't
 wish to see my users suffer for 2-4 weeks because I'm busy and
 people are pretending to be polite.
 
 I have no issue with this policy, but to do it without an
 explicit option to opt-out is not acceptable to me.
 
 This certainly depends on the severity of the bug. If you think
 my text can be improved please provide a new patch or tell me
 what exactly you would describe differently.
 
 A patch against what? I've not seen a link, only vague references
 to the dev manual.
 
 You missed to look at the initial post which refers to
 https://bugs.gentoo.org/show_bug.cgi?id=445402
 which includes a patch for the devmanual.
 
You are correct. I'm going to skip the back and forth on the mailing
list about why, and simply propose my changes on the bug.  This mail is
intended only as a pointer to that fact.

Thanks,
Zero
 
 The vague character of this policy is a bit on purpose, otherwise
 you would have to describe every possible case. That's not what I
 want here.
 
 If we are vaguely defining a policy of not touching other peoples 
 packages then the only specific thing in that policy should be what
 is exempt (which would be if xyz is in the metadata.xml then
 follow those instructions over this policy).
 
 This is VERY much on topic.  I am really unhappy that people are
 writing policy that will get me less help and more work, and I
 won't be happy until I have a way to tell others that in the
 metadata.xml and the policy you are writing refers to it.
 
 
 The global policy is a general policy and does not overrule any
 developer saying touch my packages at will. That would not make sense.
 There are already numerous ways to do that, in the ebuild and in the
 description field in metadata.xml.
 If you want more ways to communicate that to other devs, then propose
 something, open a bug, open a new thread.
 
 So what in this policy do you disagree with? This is _not_ just about
 your own packages, this is a tree-wide policy which is more or less
 already in action.
 
 

-BEGIN PGP SIGNATURE-
Version: GnuPG v2.0.19 (GNU/Linux)
Comment: Using GnuPG with undefined - http://www.enigmail.net/

iQIcBAEBAgAGBQJQvjbYAAoJEKXdFCfdEflK3kwP+gOpmiyJ0sbb+UNLRSgClsLb
nDC+6AmAY4ZFk0KTfjY/s8CYJ+fBWzHD1hKiT0akrb1oowMH3qcDlw7EibWUeQeE
uQ+SDrBjzEJNCtfKaRH69h/Lp0OiSKC1KENRfI1sJqY9URPgL5arYsXXSZjLraGR
/LsgnwPQd4z1TewkPA5FEUah2nAXj/BGI8t2c+h0iq8eD5bCv88hjwivdiP2xKLf
DNe7fj6KItH91Di43n+hr1B6EP50GpOwW+FBSkpbAfrgcoWuBy0hoSEoKQNgsDy3
JMpT2DHlxaTj2t3ogIA886249hCfiSjteoUaJ3GivMX+FXMSjVNIkNckrkZ+/u75
D0XecB8wJdhiMheyQ2rELsA0dPPcHjJCeIBa7Mmv5h++vEjFkGe8D8AlozK6AodI
y1ZsLVLdCKpVvikLkDIN17KxqyIZGSDbrkminqgZVdngbd5HHIhOfMvlsnPw9tzP
bv4RFbbiDPl9Q/WomvjO4ayKgg+WHToHi0TwkMFK79TQYAkOcH39THjwcEzY1q0L
4TGPhjP3X5Nkp9CSA20Z3sD2Y9maG44wZyosa/PXUJg3xNQrZQ8xkMner5tcp+0R
ozuS/ampoGDdxsR3o+8aIeQ6dDOtDX+j2T4teoMYz7u5dw8cJ7ui09QN0tsIm5Wg
1X5iMIMC0rly2VC3KOQC
=qxgs
-END PGP SIGNATURE-



Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds

2012-12-04 Thread hasufell
the patch has been modified to reflect Zero_Chaos suggestions:

- tell where to look for herd or maintainer notes (such as touch at
will): metadata.xml
- explicitly say to contact other devs if unsure how to handle a
situation, especially if it's a critical one
commit e6ebf193852f92aa1dfec162f1bcdc34e933eda1
Author: hasufell julian.osp...@googlemail.com
Date:   Sat Dec 1 00:04:51 2012 +0100

add ebuild comitting guide section

diff --git a/ebuild-committing-guide/cvs-tutorial/text.xml b/ebuild-committing-guide/cvs-tutorial/text.xml
new file mode 100644
index 000..a2bd612
--- /dev/null
+++ b/ebuild-committing-guide/cvs-tutorial/text.xml
@@ -0,0 +1,14 @@
+?xml version=1.0?
+guide self=ebuild-committing-guide/cvs-tutorial/
+chapter
+titleCVS Tutorial/title
+
+body
+p
+TODO: write something here.
+/p
+/body
+
+/chapter
+
+/guide
diff --git a/ebuild-committing-guide/ebuild-policy/text.xml b/ebuild-committing-guide/ebuild-policy/text.xml
new file mode 100644
index 000..44ce9aa
--- /dev/null
+++ b/ebuild-committing-guide/ebuild-policy/text.xml
@@ -0,0 +1,14 @@
+?xml version=1.0?
+guide self=ebuild-committing-guide/ebuild-policy/
+chapter
+titleEbuild policy/title
+
+body
+p
+TODO: write something here.
+/p
+/body
+
+/chapter
+
+/guide
diff --git a/ebuild-committing-guide/text.xml b/ebuild-committing-guide/text.xml
new file mode 100644
index 000..db8e982
--- /dev/null
+++ b/ebuild-committing-guide/text.xml
@@ -0,0 +1,23 @@
+?xml version=1.0?
+guide self=ebuild-committing-guide/
+chapter
+titleEbuild Committing Guide/title
+
+body
+p
+This section describes how to commit an ebuild. It covers the basics of handling CVS commits and desribes some ebuild and tree policies.
+/p
+/body
+
+section
+titleContents/title
+body
+contentsTree maxdepth=1/
+/body
+/section
+/chapter
+
+include href=ebuild-policy//
+include href=tree-policy//
+include href=cvs-tutorial//
+/guide
diff --git a/ebuild-committing-guide/tree-policy/text.xml b/ebuild-committing-guide/tree-policy/text.xml
new file mode 100644
index 000..1c56a00
--- /dev/null
+++ b/ebuild-committing-guide/tree-policy/text.xml
@@ -0,0 +1,23 @@
+?xml version=1.0?
+guide self=ebuild-committing-guide/tree-policy/
+chapter
+titleTree and Etiquette policy/title
+
+body
+p
+This section outlines the etiquette policy for Gentoo developers and describes common sense when dealing with problems in the tree. 
+/p
+section
+titleChanging/Fixing other developers ebuilds/title
+body
+pUsually you don't just change other developers ebuilds without a word unless you know he does not mind or if you are part of the herd involved in maintenance (those information can be found in metadata.xml). Start with filing a bug or try to catch them on IRC or via email. Sometimes you cannot reach them or there is no response to your bug. It's a good idea to consult other developers on how to handle the situation, especially if it's a critical one and needs to be handled ASAP. Otherwise a soft limit of 2 to 4 weeks depending on the severity of the bug is an acceptable timeframe before you go ahead and fix it yourself./p 
+important Common sense dictates to us that toolchain/base-system/core packages and eclasses or anything else which is delicate (e.g. glibc) or widely used (e.g. gtk+) should usually be left to those maintainers. If in doubt, don't touch it./important
+/body
+/section
+
+
+/body
+
+/chapter
+
+/guide
diff --git a/text.xml b/text.xml
index 88016b0..137a99f 100644
--- a/text.xml
+++ b/text.xml
@@ -50,6 +50,7 @@ section lists specific contributions to this manual.
 include href=quickstart//
 include href=general-concepts//
 include href=ebuild-writing//
+include href=ebuild-committing-guide//
 include href=eclass-writing//
 include href=profiles//
 include href=keywording//


Re: Proxy maintainers in metadata.xml (was Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds)

2012-12-04 Thread Diego Elio Pettenò
On 04/12/2012 10:35, Sergey Popov wrote:
 Agreed. I add description field to metadata for proxying packages, cause
 i see such field in other packages' metadata. That is it. But it would
 be better when this became official policy. At least - define actual
 maintainer first, even if he is not developer - this would never confuse
 scripts for automated bug filing

Yes if you notice I usually go around changing the order if I find the
order not matching the instruction, as the output of Portage, and thus
my script, use the first as assignee and the rest as CC.

-- 
Diego Elio Pettenò — Flameeyes
flamee...@flameeyes.eu — http://blog.flameeyes.eu/



signature.asc
Description: OpenPGP digital signature


Re: Proxy maintainers in metadata.xml (was Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds)

2012-12-04 Thread Markos Chandras
On 4 December 2012 17:28, Rick Zero_Chaos Farina zeroch...@gentoo.org wrote:
 -BEGIN PGP SIGNED MESSAGE-
 Hash: SHA1

 On 12/04/2012 12:06 PM, Diego Elio Pettenò wrote:
 On 04/12/2012 08:01, Rick Zero_Chaos Farina wrote:
 I feel the description field is already overloaded when there is a proxy
 situation, maybe it would be best to define a field for this.  Also
 english isn't primary language for everyone in the world so if the
 policy could actually be specific on this it would benefit everyone.

 Or maybe we can just agree that common sense rules all, and we always
 set the proxied maintainer as assignee, and the proxy maintainer as CC..
 because, you know, that's the only way a proxy maintainer can
 close/change a bug at all.

 That is a very good point. But being that it's a very good point it
 obviously never occurred to me that it shouldn't be spelled out in the
 metadata. Is there a policy for this as well that I am unaware of? A
 quick site:devmanual.gentoo.org proxy search indicates no
 documentation of this at all.

 http://www.gentoo.org/proj/en/qa/proxy-maintainers/index.xml?style=printable

 This page exists, but doesn't really mention anything about proper bug
 assignment. I know a lot of you have been doing this a very long time
 and there is a 'standard' way of doing things, but for us new guys if
 there is no documentation there is no policy.

Bug-wranglers are supposed to do that by default. When you see a
non-gentoo developer in metadata.xml, the default action is to assume
his is
the real maintainer and the bugs should be assigned to him. Such
guidance should be documented in the bug-wranglers project page and
not on the
proxy-maintainers one.

-- 
Regards,
Markos Chandras / Gentoo Linux Developer / Key ID: B4AFF2C2



Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds

2012-12-04 Thread Markos Chandras
On 4 December 2012 15:42, Alec Warner anta...@gentoo.org wrote:
 On Tue, Dec 4, 2012 at 1:19 AM, Markos Chandras hwoar...@gentoo.org wrote:
 On 4 December 2012 01:18, Ben de Groot yng...@gentoo.org wrote:
 On 3 December 2012 03:30, Markos Chandras hwoar...@gentoo.org wrote:


 On Dec 2, 2012 6:09 PM, Rich Freeman ri...@gentoo.org wrote:
 
  On Sun, Dec 2, 2012 at 10:21 AM, hasufell hasuf...@gentoo.org wrote:
   Only question is now what is a sane soft limit, before you go on and
   fix
   stuff.
   From a discussion in #gentoo-dev we thought 2-4 weeks depending on the
   severity of the bug is fine. Ofc this should exclude major changes or
   delicate packages from base-system/core/toolchain.
 
  Seems reasonable - I'd say 2 weeks is plenty.  Of course, if the
  maintainer explicitly rejects the change in a posting on the bug, then
  it is hands off without some kind of escalation.  Non-maintainers who
  are concerned about a package can always step up to maintain, as long
  as it involves real commitment.
 
  Oh, and on a side note Markos raises a valid point on the bug about
  whether the devmanual is a good place for policy.  The problem is that
  I'm not sure we really have a good place, especially with the ebuild
  docs gone in favor of the devmanual now.
 
  Rich
 

 Maybe adding some bits here[1] is preferred instead of the devmanual.
 Unless we agree to make devmanual a technical and non-technical document,
 which I personally don't like because it will end up being huge without 
 some
 sort of indexing/search textbox for quick queries.

 [1]
 http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2chap=2


 In my opinion we should limit the amount of places where we document
 policies and best practices. I suggest we keep only devmanual and PMS as
 authoritative documents.

 In that case we should go forward and add these kind of policies to the
 devmanual.

 --
 Cheers,

 Ben | yngwin
 Gentoo developer
 Gentoo Qt project lead, Gentoo Wiki admin

 As I said, the only drawback is that devmanual will become huge and
 without a proper search functionality, it will be a real pain to
 search
 for something quickly. Especially for new developers who are not
 familiar with how devmanual is structured.

 site:devmanual.gentoo.org term

 Works in bing, I tried it!
 It likely works in any modern search engine.


I don't quite like depending on external resources to index our
documentation. But I guess
there is no alternative at the moment

-- 
Regards,
Markos Chandras / Gentoo Linux Developer / Key ID: B4AFF2C2