ASCII art (was: lots of other threads)

Paul Hoffman <paul.hoffman@vpnc.org> Thu, 17 November 2005 22:50 UTC

Received: from localhost.cnri.reston.va.us ([127.0.0.1] helo=megatron.ietf.org) by megatron.ietf.org with esmtp (Exim 4.32) id 1EcsZy-0006rE-Hi; Thu, 17 Nov 2005 17:50:06 -0500
Received: from odin.ietf.org ([132.151.1.176] helo=ietf.org) by megatron.ietf.org with esmtp (Exim 4.32) id 1EcsZv-0006qT-Td for ietf@megatron.ietf.org; Thu, 17 Nov 2005 17:50:03 -0500
Received: from ietf-mx.ietf.org (ietf-mx [132.151.6.1]) by ietf.org (8.9.1a/8.9.1a) with ESMTP id RAA01917 for <ietf@ietf.org>; Thu, 17 Nov 2005 17:49:29 -0500 (EST)
Received: from above.proper.com ([208.184.76.39]) by ietf-mx.ietf.org with esmtp (Exim 4.43) id 1Ecsrd-00064b-SF for ietf@ietf.org; Thu, 17 Nov 2005 18:08:23 -0500
Received: from [10.20.30.249] (dsl2-63-249-109-231.cruzio.com [63.249.109.231]) (authenticated bits=0) by above.proper.com (8.12.11/8.12.9) with ESMTP id jAHMntWB010853 for <ietf@ietf.org>; Thu, 17 Nov 2005 14:49:56 -0800 (PST) (envelope-from paul.hoffman@vpnc.org)
Mime-Version: 1.0
Message-Id: <p062309ccbfa2b7337b26@[10.20.30.249]>
In-Reply-To: <tslirurosdr.fsf@cz.mit.edu>
References: <198A730C2044DE4A96749D13E167AD377C2135@MOU1WNEXMB04.vcorp.ad.vrsn.com> <tslirurosdr.fsf@cz.mit.edu>
Date: Thu, 17 Nov 2005 14:49:23 -0800
To: ietf@ietf.org
From: Paul Hoffman <paul.hoffman@vpnc.org>
Content-Type: text/plain; charset="us-ascii"; format="flowed"
X-Spam-Score: 0.0 (/)
X-Scan-Signature: 52e1467c2184c31006318542db5614d5
Subject: ASCII art (was: lots of other threads)
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www1.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www1.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
Sender: ietf-bounces@ietf.org
Errors-To: ietf-bounces@ietf.org

At 4:51 PM -0500 11/17/05, Sam Hartman wrote:
>  >>>>> "Hallam-Baker," == Hallam-Baker, Phillip <pbaker@verisign.com> writes:
>
>
>     Hallam-Baker,> I do not think that you really care about
>     Hallam-Baker,> accessibility. If you did you would understand why
>     Hallam-Baker,> the idea of putting ASCII art through a text to
>     Hallam-Baker,> speech interface is utterly ridiculous. At least in
>     Hallam-Baker,> HTML the voice synthesizer knows that it has come
>     Hallam-Baker,> to a diagram that it should not attempt to
>     Hallam-Baker,> interpret.
>
>
>I actually can get some content out of ascii art diagrams.

Oh, Sam, why ruin a perfectly good rant with real-life data?

>I wouldn't mind though if the IETF went away from ascii diagrams
>provided that they commit to guaranteeing that the normative text is
>complete without the diagrams.  No, doing that is not as hard as some
>people seem to think.

Many ASCII-art diagrams *supplement*, rather than replace, prose 
descriptions. Given what many of us have seen in deployed 
implementations of IETF protocols, it is naive to assume that saying 
something in just one fashion is sufficient for it to be understood. 
In some WGs, when the ASCII art conflicts with the text above or 
below it, it leads to a useful discussion of how to fix the body text.

A good test for a document in mid-development would be "cover up the 
ASCII art and see if the body text is still understandable". The same 
would be true for documents where there is explanatory text and { 
ABNF | C code | Perl code | ASN.1 | ... }.

--Paul Hoffman, Director
--VPN Consortium

_______________________________________________
Ietf mailing list
Ietf@ietf.org
https://www1.ietf.org/mailman/listinfo/ietf