Re: [tao-discuss] Glitches in Tao of the IETF Revision
Niels ten Oever <mail@nielstenoever.net> Tue, 16 April 2019 01:51 UTC
Return-Path: <mail@nielstenoever.net>
X-Original-To: tao-discuss@ietfa.amsl.com
Delivered-To: tao-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 318EF1201C1 for <tao-discuss@ietfa.amsl.com>; Mon, 15 Apr 2019 18:51:29 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id hSXqAlMqwNUA for <tao-discuss@ietfa.amsl.com>; Mon, 15 Apr 2019 18:51:26 -0700 (PDT)
Received: from smarthost1.greenhost.nl (smarthost1.greenhost.nl [195.190.28.88]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 4F6A91201C0 for <tao-discuss@ietf.org>; Mon, 15 Apr 2019 18:51:26 -0700 (PDT)
Received: from smtp.greenhost.nl ([213.108.110.112]) by smarthost1.greenhost.nl with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.89) (envelope-from <mail@nielstenoever.net>) id 1hGDFr-000106-Ko; Tue, 16 Apr 2019 03:51:24 +0200
In-Reply-To: <7450F3A1-9144-4408-80D7-4D2B983AD9CC@apple.com>
References: <7450F3A1-9144-4408-80D7-4D2B983AD9CC@apple.com>
X-Referenced-Uid: 13549
Thread-Topic: [tao-discuss] Glitches in Tao of the IETF Revision
X-Blue-Identity: !l=66&o=96882&fo=100197&pl=45&po=0&qs=PREFIX&f=HTML&n=Niels%20ten%20Oever&e=mail%40nielstenoever.net&m=!%3ANzdmMDE1OWYtOWM0ZS00OGI3LTg0N2YtY2ZjNjBmMWNlYzhm%3ASU5CT1g%3D%3AMTM1NDk%3D%3AANSWERED&p=45&q=SHOW
X-Is-Generated-Message-Id: true
User-Agent: Android
MIME-Version: 1.0
Content-Type: multipart/alternative; boundary="----B72XGFNHIP9NV380DBTBPUP0G3EJSH"
Content-Transfer-Encoding: 7bit
From: Niels ten Oever <mail@nielstenoever.net>
Date: Tue, 16 Apr 2019 09:48:46 +0800
To: Stuart Cheshire <cheshire=40apple.com@dmarc.ietf.org>
CC: tao-discuss@ietf.org
Message-ID: <a0e933ba-0faa-4348-849e-d3c91cab17d9@nielstenoever.net>
X-Authenticated-As-Hash: f1842a279235a42f6aa2a2a81130733515c5a4ec
X-Virus-Scanned: by clamav at smarthost1.samage.net
X-Scan-Signature: 535c43b1e2e4460e348b3940d95530cd
Archived-At: <https://mailarchive.ietf.org/arch/msg/tao-discuss/M7oukASbewfyvizwxasdz6N3KQ8>
Subject: Re: [tao-discuss] Glitches in Tao of the IETF Revision
X-BeenThere: tao-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Discussion of the Tao of the IETF <tao-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tao-discuss>, <mailto:tao-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tao-discuss/>
List-Post: <mailto:tao-discuss@ietf.org>
List-Help: <mailto:tao-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tao-discuss>, <mailto:tao-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 16 Apr 2019 01:51:29 -0000
Hi Stuart, Thanks a lot for your comments, this version is now under IESG review, but I am sure that if you make a pull request they will include that in their review: https://github.com/nllz/Tao-of-the-IETF/blob/master/Tao.md Any XML magic to fix the numbering and auto-generate the Table of Content would also be very much appreciated. All the best, Niels On Apr 16, 2019, 09:11, at 09:11, Stuart Cheshire <cheshire=40apple.com@dmarc.ietf.org> wrote: >This weekend I reviewed “Tao of the IETF - Possible Revision” > ><https://www.ietf.org/about/participate/tao/tao-possible-revision/> > >I think this is a great improvement over the existing document, and >should be made official as soon as possible. The current version is >seven years old now, and some important things have changed in that >time. Also, some attitudes have changed too, and the new wording >reflects this appropriately: > >attendance → participation >novices → newcomers >http → https > >The new revision remains light-hearted, but omits some of the >excessively frivolous text from the 2012 version. Some of those inside >jokes were arguably funny, but inside jokes are precisely what is *not* >salient to a newcomer. > >I did notice a few glitches: > >Sometimes the web page appears blank. Start with a wide web browser >window, as wide as your screen allows, blank. Then open ><https://www.ietf.org/about/participate/tao/tao-possible-revision/>. if >your window is wide enough you should see the little table of floating >links top right. Now make the web browser window narrower until the >little table of floating links disappears. The entire page content >disappears with it, and the entire top half of the scrollable page >content area becomes blank space. > >There are several places where the text switches to monospaced font. Is >this intentional? > >There are several places where “a href” tags appear in the text, e.g.: > >> A good summary of this can be found in the aptly titled <a >href="https://tools.ietf.org/html/rfc1796">RFC 1796</a>, "Not All RFCs >Are Standards”. > >In the Table of Contents all the main section numbers are off by one. >And I don’t think the Table of Contents itself needs to be entry number >1 in the Table of Contents (which I think is the cause of them being >off by one). > >The main section heading numbering in the body text is messed up. For >example: > >12. Introduction (Should be section 1) > >All the other main section heading numbers in the body text, that >should be 2, 3, 4, 5, etc., all appear with number “1”. > >There are a few other minor spelling and grammar typos I noticed. If >this document lives in a Git repository or similar, let me know and I’m >happy to contribute a Git pull request with my suggested fixes. > >Stuart Cheshire > >_______________________________________________ >tao-discuss mailing list >tao-discuss@ietf.org >https://www.ietf.org/mailman/listinfo/tao-discuss
- [tao-discuss] Glitches in Tao of the IETF Revision Stuart Cheshire
- Re: [tao-discuss] Glitches in Tao of the IETF Rev… Niels ten Oever
- Re: [tao-discuss] Glitches in Tao of the IETF Rev… Robert Sparks