Proposal for an additional (sub)section in the porters handbook

[Pav Lucistnik]

Alexander Leidinger píše v po 05. 12. 2005 v 11:29 +0100:
> Pav Lucistnik <pav at FreeBSD.org> wrote:
> 
> > Alexander Leidinger píse v po 05. 12. 2005 v 09:40 +0100:
> >> Adam Weinberger <adamw at FreeBSD.org> wrote:
> >> > Alexander Leidinger wrote:
> >
> >> >> Some maintainers prefer to use install-time plists. While the use of
> >> >> them is not forbitten, maintainers have to use commit-time plists
> >> >> wherever possible.
> >> >
> >> > See, as soon as you use "have to", you've negated any purpose of your
> >> > addition past political rhetoric. The entire thing could be shortened
> >>
> >> Ah! Pav, did you referenced to this as being "political" as well? I thought
> >> you talked about the "benefits"-list. Ok, I will change this.
> >
> > Possibly.
> >
> > I have an experience that every extra sentence equals to a percentage of
> > readers not reading the text at all. Thus, I prefer to keep the texts in
> > Porter's Handbook down to the minimum, while saying everything
> > important.
> >
> > Think law book. You don't justify the rules in the law book. You just
> > say this will be done, this can be done, this is prohibited.
> 
> Uhm... now I don't know where to go. If we talk about a law book I prefer to
> talk with "must" and "must not" instead of "should" and "should not". My
> main motivation to not use "should" is the way a "should" is handled in
> RFC's. It's a "you do *not* have to care about this", but the intend of this
> additional section is "you *have* to care about this".

Yeah, this is not an RFC, thanks god. You can put "We really like to see
a static plist whenever feasible." and no one is gonna sue you about it.

It's all about the fun and games, in the end, right? This is not worth
hard policy and fighting. But it's good to have an official doc in hand
to beat lazy maintainers over the fingers with.

-- 
Pav Lucistnik <pav at oook.cz>
              <pav at FreeBSD.org>

A cow is a sphere that emits milk into all directions.
At least to a first approximation.
  -- An unknown physicist
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: Toto je =?iso-8859-2?Q?digit=E1ln=EC?=
	=?ISO-8859-1?Q?_podepsan=E1?= =?iso-8859-2?Q?_=E8=E1st?=
	=?ISO-8859-1?Q?_zpr=E1vy?=
Url : http://lists.freebsd.org/pipermail/freebsd-ports/attachments/20051205/c29539e2/attachment.bin