From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 6F4601381F3 for ; Thu, 6 Dec 2012 10:54:20 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 3126A21C015; Thu, 6 Dec 2012 10:54:08 +0000 (UTC) Received: from mail-vb0-f52.google.com (mail-vb0-f52.google.com [209.85.212.52]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 5CA9FE0508 for ; Thu, 6 Dec 2012 10:53:35 +0000 (UTC) Received: by mail-vb0-f52.google.com with SMTP id ez10so3734906vbb.11 for ; Thu, 06 Dec 2012 02:53:34 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:reply-to:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:content-type; bh=vuXL8JNccKEkrv6rXATxYG5XWqpog9LwyYIYGTdyN2g=; b=UWXNSgFizqFwYmp4Zj8xEPF6JDW8GbXHE4fLbylJjm7CYYR0l4seiSwL2TLII3NJuQ uV57qFCW76ba0sXFVwS6ciBSTlsbFFT6W/Jsw9ymZcZYFx0WPiJysIzRROT12py8od1L zsgyudkCC7dN2AcBfeY1RW3BCdmBoXcGGO217hrTRPNfGEEUSO4kJl9Ou5QYADX+x/n5 pu0404rKHsMWaCC614sSFXxl9ehDi9QfJx3hqJ6hwChiz/aLJz/2aYaB58eQ33Z1sO1M HKG4iDdplPCjMJCyb18HA33hQR5eUUCoBKAeaVRuvR3FKY+Z18nUi7HagvKLiHbq1v6j IVNg== Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org MIME-Version: 1.0 Received: by 10.58.221.228 with SMTP id qh4mr571972vec.49.1354791214442; Thu, 06 Dec 2012 02:53:34 -0800 (PST) Sender: yngwin@gmail.com Received: by 10.58.4.169 with HTTP; Thu, 6 Dec 2012 02:53:34 -0800 (PST) In-Reply-To: References: <50BB71DD.4080308@gentoo.org> Date: Thu, 6 Dec 2012 18:53:34 +0800 X-Google-Sender-Auth: bRViuU0kNiunrAMZg6XYyZmbPlM Message-ID: Subject: Re: [gentoo-dev] introduce a soft-limit policy for changing other developers ebuilds From: Ben de Groot To: gentoo-dev Content-Type: multipart/alternative; boundary=047d7bdc7a9a14e8eb04d02ce9de X-Archives-Salt: 85bfa88a-ef69-41c9-b06e-b6ad2ff66414 X-Archives-Hash: 68732d7d330f724f539a1509b0a9ae11 --047d7bdc7a9a14e8eb04d02ce9de Content-Type: text/plain; charset=UTF-8 On 4 December 2012 17:19, Markos Chandras wrote: > On 4 December 2012 01:18, Ben de Groot wrote: > > 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 > > Except the situation now is worse. Things are spread over multiple documents, and we don't have a proper site search. Even so, 1) Google is your friend, and 2) a single document with a good index would be a step forward. -- Cheers, Ben | yngwin Gentoo developer Gentoo Qt project lead, Gentoo Wiki admin --047d7bdc7a9a14e8eb04d02ce9de Content-Type: text/html; charset=UTF-8 Content-Transfer-Encoding: quoted-printable
On 4 December 2012 17= :19, Markos Chandras <hwoarang@gentoo.org> wrote:
On 4 December 2012 01:18, Ben de Gr= oot <yngwin@gentoo.org> wrot= e:
> 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 th= e
> 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 t= o
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


Except the situation now is worse. Thi= ngs are spread over multiple documents, and we don't have a proper site= search.

Even so, 1) Google is your friend, and 2) a single document= with a good index would be a step forward.

--
Cheers,

Ben | yngwin
Gentoo developer
Gentoo Qt pro= ject lead, Gentoo Wiki admin
--047d7bdc7a9a14e8eb04d02ce9de--