On 4 December 2012 17:19, Markos Chandras <hwoarang@gentoo.org> wrote:
On 4 December 2012 01:18, Ben de Groot <yngwin@gentoo.org> 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