Re: [gentoo-dev] Re: Warn users not to do separate /usr partition without proper initramfs in the handbook?

[Dale]

Robin H. Johnson wrote:
> On Tue, Aug 16, 2011 at 03:55:23PM -0500, Dale wrote:
>
>>> Did he file a bug for this? We have been working on them.
>>>
>> Nope.  He's a ghost Gentoo user.  I don't think he is subscribed to any
>> mailing list or the forums.  He just searches for clues and docs.
>>
> Can you please data-capture that bug and file it for him then.
>
> We really need to hear about hidden bugs like this.
>
>

He has been talking to someone but no clue who.  I'm not even sure it is 
a dev or anything.  I think to have a bug, there has to be something 
first.  I think his point was, once you get sort of advanced with the 
new openrc networking, there is little docs to follow.  Me, I use DHCP 
and it "just works" for me.  Thank goodness for that.

>> I have to say, the docs seem to be lacking on updates.  I think it is a
>> lack of manpower so my hats off to the few, maybe even one, that is
>> working hard to do what is done.  I wish I could help more.  I'm
>> disabled and have more time than most to do it but the xml thingy is
>> Greek to me.
>>
> Write plaintext (or wiki markup), adding the XML is a fairly trivial
> transform.
>
>

That is good to know.  May have to poke my head in the door on -doc 
then.  Maybe this old fart can do something after all.  ;-)

>> Some things are more important and some may not be such a huge deal
>> but networking is something that about every computer has to have and
>> some setups are complicated and need to have good docs to back those
>> people up.
>>
> I've got some very complex network setups that I have documented and
> supported. My homedir has several of them from my own experience:
> http://dev.gentoo.org/~robbat2/conf.d-net/
> Includes dual-homing, multi-homing, and HE.net IPv6 tunnels.
> I wrote a lot of the original bonding, vlan, mac-changer, bridging code
> in BL1.
>
> Better documentation on how to set up the complex network configs would
> be great, but the net.example is too long already.
>
>

I passed the link on to him.  I'll let you know if it helps.  If he 
comes up with anything that can be added to the docs, I'll post them on 
-doc.  Maybe someone can take it from there.

Sometimes docs can be to long but I have always found this to be 
useful.  Have a simple setup first then follow that with the complicated 
stuff and let it get more complicated as it goes deeper down.  That 
helps the simple setups quickly but still provides needed info for folks 
with the complicated setups.  I wish some things were longer sometimes.  
USE descriptions is one of those at times.

Thanks.

Dale

:-)  :-)