Gentoo Archives: gentoo-dev

From: Joshua Saddler <nightmorph@g.o>
To: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] openrc stabilization update
Date: Mon, 20 Sep 2010 17:49:33
Message-Id: 20100920104908.754fc26d@angelstorm
In Reply to: Re: [gentoo-dev] openrc stabilization update by "Anthony G. Basile"
1 -----BEGIN PGP SIGNED MESSAGE-----
2 Hash: SHA1
3
4 On Mon, 20 Sep 2010 06:46:21 -0400
5 "Anthony G. Basile" <blueness@g.o> wrote:
6
7 > Why can't we keep both? There are strong advantages/disadvantages
8 > either way and there are users invested in both new/oldnet. I know
9 > this is more work on doc writers, but I don't think that will equal
10 > the pain users will experience being forced one way or another.
11
12 Wrong. It will. The GDP--that's effectively just me--will already have to rewrite every single one of hundreds of pages of documentation to allow for the new syntax and way of doing things present in the "oldnet" behavior of OpenRC. That's ~weeks to ~months of work, even if there's someone besides me doing it. I'll have to do all that effort and time commitment yet again if we have to rewrite everything once "newnet" becomes the default after everyone uses "oldnet" for a while.
13
14 Worse yet, if BOTH are enabled, and we have to document both simultaneously. Then we'd have to fill up our docs with stupid conditionals: "IF you're using oldnet, use THIS complicated config, but IF you're using newnet, then follow THIS complicated set of steps."
15
16 Documenting both config styles, whether simultaneously or sequentially, is massively complex, unnecessary, and a complete waste of time. I'd probably quit if I had to redo everything more than once, and then there would be absolutely no one to work on any docs. That's not a threat by the way, just a statement of likely outcome. I simply wouldn't have enough spare time to adjust the suddenly "broken" mass of documentation for the new config style.
17
18 Please. Just stick to *one* config. I strongly suggest that it be "oldnet," given all the problems with "newnet" raised in this thread. But more importantly, because *the groundork has already been done* when I wrote the OpenRC Migration Guide. I can piggyback all my efforts off that guide, which will greatly shorten the amount of time needed for the rest of the documentation. Otherwise a completely new "migration" guide will have to be written, AND all the docs will need to be adjusted to THAT one.
19 -----BEGIN PGP SIGNATURE-----
20 Version: GnuPG v2.0.16 (GNU/Linux)
21
22 iEYEARECAAYFAkyXnpYACgkQxPWMzpKk6kNdZwCgrVN6D12QzaHw5lXZl+h610PL
23 /ccAni2xDC+CWwkTw9GKBCvjT/IDqcj9
24 =RxdN
25 -----END PGP SIGNATURE-----

Replies

Subject Author
Re: [gentoo-dev] openrc stabilization update Mike Frysinger <vapier@g.o>