bad howto warning: Re: [gentoo-user] updating mostly identical systems

2005-08-04 Thread Eric S. Johansson

Michael Crute wrote:
Have you seen the build host tutorial on the wiki? 
http://gentoo-wiki.com/HOWTO_Create_A_Build_Host


to put it politely, this how-to is misleading.  It should be removed.

problem 1: assumes automounter works.  I was not able to get automounter 
to function and had to resort to normal NFS mounts.  I verified with a 
few people outside of the Linux community that automounter is 
problematic no matter who's you use.


problem 2: does not tell you which directories to create.  I've had to 
determine that experimentally as I've gone along.  I'll probably 
document on the second machine install.


Problem 3: inadequate chroot environment set up.  As a result, Shell 
scripts that should run chrooted don't.  In fact, they just don't run.


that is as far as I've gotten.  Until I solved the chroot problem, I'm 
pretty well stopped.


I think this how-to is a good example of a really bad how to.  Yes it is 
perfectly acceptable to say go look here when dealing with something 
essential to the how-to that was previously documented.  But you must 
put the reference to other documentation in context including context 
specific debugging sequences.  That would have saved me hours with the 
automounter because I would have known to to quit far earlier and gone 
to a more reliable system (assuming NFS is reliable).


as I solve problems, I will probably post the documentation here.

---eric
--
gentoo-user@gentoo.org mailing list



Re: bad howto warning: Re: [gentoo-user] updating mostly identical systems

2005-08-04 Thread Justin Patrin
On 8/4/05, Eric S. Johansson [EMAIL PROTECTED] wrote:
 Michael Crute wrote:
  Have you seen the build host tutorial on the wiki?
  http://gentoo-wiki.com/HOWTO_Create_A_Build_Host
 
 to put it politely, this how-to is misleading.  It should be removed.
 

Well, since this is a wiki...why don't you edit it?

-- 
Justin Patrin

-- 
gentoo-user@gentoo.org mailing list



Re: bad howto warning: Re: [gentoo-user] updating mostly identical systems

2005-08-04 Thread Michael Crute
Bingo... edit it please... share your experiences and put down the right way to do it. 

-MikeOn 8/4/05, Justin Patrin [EMAIL PROTECTED] wrote:
On 8/4/05, Eric S. Johansson [EMAIL PROTECTED] wrote: Michael Crute wrote:  Have you seen the build host tutorial on the wiki?  
http://gentoo-wiki.com/HOWTO_Create_A_Build_Host to put it politely, this how-to is misleading.It should be removed.Well, since this is a wiki...why don't you edit it?--Justin Patrin
--gentoo-user@gentoo.org mailing list-- Michael E. CruteSoftware Developer
SoftGroup Development CorporationIn a world without walls and fences, who needs windows and gates?