From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: <mwlang@cybrains.net> 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 <gentoo-dev@gentoo.org>; 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 <mwlang@cybrains.net> 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: <mailto:gentoo-dev-request@gentoo.org?subject=help> List-Post: <mailto:gentoo-dev@gentoo.org> List-Subscribe: <http://lists.gentoo.org/mailman/listinfo/gentoo-dev>, <mailto:gentoo-dev-request@gentoo.org?subject=subscribe> List-Id: Gentoo Linux developer list <gentoo-dev.gentoo.org> List-Unsubscribe: <http://lists.gentoo.org/mailman/listinfo/gentoo-dev>, <mailto:gentoo-dev-request@gentoo.org?subject=unsubscribe> List-Archive: <http://lists.gentoo.org/pipermail/gentoo-dev/> 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 <uri link="#doc_chap15_sect2" easily becomes invalid during the editing process. BTW, #doc_chap_15_sect2 doesn't work at all even though both do exist...looking at the generated HTML, it looks like the sections aren't getting "defined" at the top of the document as the chapters are. Anyway, not to get off track from the first problem...I think this would work much better if we can explicitly name the chapters and sections in the documents...i.e. instead of: <chapter><title>Installing a Bootloader</title>.... we do this: <chapter name=bootloader><title>Installing a Bootloader</title> Then no matter where that final chapter ends up, when we say <uri link="#bootloader">Installing a Bootloader</uri>, 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 <uri>#bootloader</uri> 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 <drobbins@gentoo.org> >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