From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 4.0.0 (2022-12-14) on finch.gentoo.org X-Spam-Level: X-Spam-Status: No, score=-1.0 required=5.0 tests=DMARC_MISSING, MAILING_LIST_MULTI autolearn=unavailable autolearn_force=no version=4.0.0 Received: from smtp10.atl.mindspring.net (smtp10.atl.mindspring.net [207.69.200.246]) by chiba.3jane.net (Postfix) with ESMTP id EF5C920ED31D for ; Fri, 15 Mar 2002 14:45:18 -0600 (CST) Received: from user-1120tad.dsl.mindspring.com ([66.32.117.77] helo=stinger.cybrains.net) by smtp10.atl.mindspring.net with esmtp (Exim 3.33 #1) id 16lyWD-0004Vl-00 for gentoo-dev@gentoo.org; Fri, 15 Mar 2002 15:41:41 -0500 Message-Id: <5.1.0.14.2.20020315152120.03becbf0@mail.cybrains.net> X-Sender: mwlang%cybrains.net@mail.cybrains.net X-Mailer: QUALCOMM Windows Eudora Version 5.1 Date: Fri, 15 Mar 2002 15:35:04 -0500 To: gentoo-dev@gentoo.org From: Michael Lang Subject: Re: [gentoo-dev] New Install Instructions In-Reply-To: <1016212293.20823.32.camel@inventor.gentoo.org> References: <5.1.0.14.2.20020315013412.0207d7e8@mail.cybrains.net> <5.1.0.14.2.20020315013412.0207d7e8@mail.cybrains.net> Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii"; format=flowed Sender: gentoo-dev-admin@gentoo.org Errors-To: gentoo-dev-admin@gentoo.org X-BeenThere: gentoo-dev@gentoo.org X-Mailman-Version: 2.0.6 Precedence: bulk Reply-To: gentoo-dev@gentoo.org List-Help: List-Post: List-Subscribe: , List-Id: Gentoo Linux developer list List-Unsubscribe: , List-Archive: X-Archives-Salt: 95fcb1ab-db77-4ab1-a5d2-26a1927b210c X-Archives-Hash: 2b83a08e90f7674d57d29b397b3c31d9 No Problem. I will give it my attention for the next couple days and then submit to bugzilla. One thing I would like to comment on...the intra-doc links are a bit difficult to work with, esp. if you add/delete chapters and sections or just move them around. As soon as you do this a like like Installing a Bootloader.... we do this: Installing a Bootloader Then no matter where that final chapter ends up, when we say Installing a Bootloader, we are assured that the link works as long as we don't delete the chapter or arbitrarily rename it. Ditto for sections. Another thought: If we do shorthand #bootloader Then the transformer should automatically plug in the title of the chapter...if for some reason a chapter title doesn't exist, then plug in "Chapter 1", etc.. The nice thing about this is that the author no longer cares what the chapter title is and doesn't have to carefully proofread the final work to ensure all references to that chapter match the chapter title exactly. At 10:11 AM 3/15/2002 -0700, you wrote: >On Thu, 2002-03-14 at 23:34, Michael Lang wrote: > > Here are the new install instructions. Not knowing the "proper" way to > put > > this out for review, I have put it up at the following URL (my pardons if > > this breaks any protocols): > > > > http://www.gibberishcode.net/gentoo-web/xsl/build.html > >I like your new instructions. Please continue to refine them based on >comments in here, and then when you feel they're ready, submit them on >bugzilla and we'll do one last edit and then make them our official >docs. I think they're better than what we have. > >Best Regards, > >-- >Daniel Robbins >Chief Architect/President http://www.gentoo.org >Gentoo Technologies, Inc. > >_______________________________________________ >gentoo-dev mailing list >gentoo-dev@gentoo.org >http://lists.gentoo.org/mailman/listinfo/gentoo-dev President www.cybrains.net "All things should be as simple as possible, but no simpler" -- Albert Einstein