[gentoo-project] Re: improving alternative PM support in gentoo

[Martin Vaeth]

Michał Górny <mgorny@g.o> wrote:
> Martin Vaeth <martin@×××××.de> napisa=C5=82(a):
>
>> Alexander Berntsen <bernalex@g.o> wrote:
>> >
>> > What I'd like to see for the handbook is basically it being turned
>> > into a choose-your-own-adventure book, with an index and a "view all
>> > options"-type of presentation.
>>
>> This has two major obstacles:
>>
>> 1. Users should be able to get a complete copy (also a printed copy)
>> with *full* installation instructions for some setup.
>> In fact, users might not have (easy) access to the internet before
>> the installation process is completed.
>>
>> 2. If you have many alternatives, all of these alternatives
>> must be maintained very regularly. Currently, the handbook
>> has already troubles in keeping up-to-date with *one* option.
>
> So, say, should we switch the handbook to systemd if systemd people are
> going to have less trouble updating it? :P

I cannot see any relation between your remark and what I wrote.
Essentially, I think it is best to leave the handbook as it is now:
Have *one* reasonable alternative carried out and refer to others
to Wiki or some other source.
Of course, eventually some outdated alternative might be replaced
by something else, but which variant to use of what is a completely
independent discussion: It should essentially be made by the
authors of the handbook since they have to maintain it.
I do not suppose that openrc is going from the handbook soon
(and I would not suggest such a change): It already *is*
described well in the handbook and certainly simpler to maintain
than a systemd description which would change all of the time
and would need a huge troubleshooting section.
(BTW, isn't the handbook essentially the only existing openrc
documentation anyway?)