Re: [gentoo-dev] New QA Policy Guide

[Michał Górny]

On Sun, 2020-01-19 at 19:34 +0000, Robin H. Johnson wrote:
> On Sun, Jan 19, 2020 at 12:31:52PM +0100, Michał Górny wrote:
> > Hello,
> >
> > In the light of the recent misunderstandings, I have started working
> > on an official Policy Guide [1].  The Guide is meant to provide
> > a focused list of officially approved QA policies, along with their
> > rationale and any other useful information.
> >
> > This should supplement devmanual [2] with clear information on what is
> > enforceable policy, and what is merely a suggestion (or possibly
> > outdated information, which is a common problem for devmanual).
> Thank you for this this!
>
> I have some requests for improvement & content.
>
> 1. Stable identifiers for policy:
> Assign ID numbers or stable identifying slugs to each policy and use
> them for referencing from all tooling in future. Also makes searching
> MUCH easier.
>
> The ID variant might be 'GPNNNNN' (string prefix, followed by numeric
> value)
>
> The slug variant (modelled after Rubocop) might be
> "Ebuild:CodingStyle"
>
> My personal preference would be the ID variant, after seeing Rubocop
> have to rename identifying slugs slowly & painfully over many years;
> however the slug variant is MUCH better for usability
>
> 2. Usability/viewing:
> 2.1. DT-squashed:
> Please fix the CSS rendering of the <dt>. My chrome window is 1198 x
> 1870 (screen is portrait version 1920x1200).
> Screenshot:
> https://dev.gentoo.org/~robbat2/.private/20200119-policy-guide-render-window.png
>
> 2.2. Whitespace:
> The left column has a LOT of wasted whitespace.
>
> 2.3 Navigation:
> Please add next/previous links on the top AND bottom of each page.
>

Ok, I am sorry.  I've sent this mail with the conviction that new
version was deployed but I've been informed that it didn't.  I've
manually updated the site now, and it should show the new theme after
refresh.

-- 
Best regards,
Michał Górny