[salud] Editorial improvements to draft-ietf-salud-alert-info-urns-14

worley@ariadne.com (Dale R. Worley) Fri, 21 November 2014 01:29 UTC

Return-Path: <worley@ariadne.com>
X-Original-To: salud@ietfa.amsl.com
Delivered-To: salud@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 222621ACFE9 for <salud@ietfa.amsl.com>; Thu, 20 Nov 2014 17:29:02 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1] autolearn=ham
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 3IFq3hhrRyTn for <salud@ietfa.amsl.com>; Thu, 20 Nov 2014 17:29:00 -0800 (PST)
Received: from resqmta-ch2-04v.sys.comcast.net (resqmta-ch2-04v.sys.comcast.net [IPv6:2001:558:fe21:29:69:252:207:36]) (using TLSv1.2 with cipher DHE-RSA-AES128-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 4965B1ACFE8 for <salud@ietf.org>; Thu, 20 Nov 2014 17:29:00 -0800 (PST)
Received: from resomta-ch2-03v.sys.comcast.net ([69.252.207.99]) by resqmta-ch2-04v.sys.comcast.net with comcast id J1Ua1p00229Cfhx011UztE; Fri, 21 Nov 2014 01:28:59 +0000
Received: from hobgoblin.ariadne.com ([24.34.72.61]) by resomta-ch2-03v.sys.comcast.net with comcast id J1Uy1p00Z1KKtkw011UyPe; Fri, 21 Nov 2014 01:28:59 +0000
Received: from hobgoblin.ariadne.com (hobgoblin.ariadne.com [127.0.0.1]) by hobgoblin.ariadne.com (8.14.7/8.14.7) with ESMTP id sAL1SvW4026347; Thu, 20 Nov 2014 20:28:57 -0500
Received: (from worley@localhost) by hobgoblin.ariadne.com (8.14.7/8.14.7/Submit) id sAL1SviD026344; Thu, 20 Nov 2014 20:28:57 -0500
Date: Thu, 20 Nov 2014 20:28:57 -0500
Message-Id: <201411210128.sAL1SviD026344@hobgoblin.ariadne.com>
From: worley@ariadne.com
Sender: worley@ariadne.com
To: salud@ietf.org
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comcast.net; s=q20140121; t=1416533339; bh=jfPhduGCA9bLY7XAur80cHHKcnoahQF82T4oUllUcRE=; h=Received:Received:Received:Received:Date:Message-Id:From:To: Subject; b=EUPK4zq8JHxU13uyNOWhlcqaJvqRfm9rD5IECnS+HNyLaziLxyjZpzoIkLuraErMY 7/qBwFXsHX/sWETiCDrnw0eEPVycQ/i3ezv0RyGQ7LG2n8EX2nnESG8TDPTYNsxKWc PFSXk7QDLsyFHZiVtzdd9E8NVQrV/X//tkC1Khw/gUpk+Q+xtfPYaVRDQ5mB/yG07f b2sqiyRjMl2IDs6LdNhyC4Rzufj9dW8qKB5nxBU6fex2TPOaQZlqyUeL6lCVil58uf +uLXFyq+U2Q1+/fAVwsdFHwwYu+PDqtJXFnqQKo28o0e+tOMI+7zwVRr7Q5FF0XbzO fkc1mR/KqcKmg==
Archived-At: http://mailarchive.ietf.org/arch/msg/salud/ukJy7ZZh4LgWZdKjkLdwFhg9O48
Subject: [salud] Editorial improvements to draft-ietf-salud-alert-info-urns-14
X-BeenThere: salud@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: Sip ALerting for User Devices working group discussion list <salud.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/salud>, <mailto:salud-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/salud/>
List-Post: <mailto:salud@ietf.org>
List-Help: <mailto:salud-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/salud>, <mailto:salud-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 21 Nov 2014 01:29:02 -0000

[as an author]

Here are a couple of editorial items I think could be improved.  The
first is a simple typo.  The second is changing the numbering of
sections.  What do people think?

Item 1:

   9.1.2.  Initial IANA Registration

   This document defines the <alert-category>s 'service', 'source',
   'priority', 'duration', 'delay' and 'locale'.  The entries to be
   added to the Alert URN Identifiers 'registry table' for each <alert-
   category> are given in the respective sections below.

One pair of quotes are misplaced; it should say "'Alert URN
Identifiers' registry table".

Item 2:

Currently, section 9 is organized this way:

   9.  IANA Considerations
     9.1.  URN namespace identifier "alert"
       9.1.1.  'Alert URN Identifiers' Registry
       9.1.2.  Initial IANA Registration
	 9.1.2.1.  The "service" <alert-category> and <alert-identifier>s
	 9.1.2.2.  The "source" <alert-category> and <alert-identifier>s
	 9.1.2.3.  The "priority" <alert-category> and <alert-identifier>s
	 9.1.2.4.  The "duration" <alert-category> and <alert-identifier>s
	 9.1.2.5.  The "delay" <alert-category> and <alert-identifier>s
	 9.1.2.6.  The "locale" <alert-category> and <alert-identifier>s
     9.2.  'Alert URN Providers' Registry

Section 9.1 specifies the registrion of the "alert" namespace.
Sections 9.1.1 and 9.1.2 and their descendants specify the alert
identifiers registry.  Section 9.2 specified the alert providers
registry.

Putting the alert identifiers registry under 9.1 seems incorrect to
me.  I think we want to reorganize the sections in this way:

   9.  IANA Considerations
     9.1.  URN namespace identifier "alert"
     9.2.  'Alert URN Identifiers' Registry
       9.2.1.  Initial IANA Registration
	 9.2.1.1.  The "service" <alert-category> and <alert-identifier>s
	 9.2.1.2.  The "source" <alert-category> and <alert-identifier>s
	 9.2.1.3.  The "priority" <alert-category> and <alert-identifier>s
	 9.2.1.4.  The "duration" <alert-category> and <alert-identifier>s
	 9.2.1.5.  The "delay" <alert-category> and <alert-identifier>s
	 9.2.1.6.  The "locale" <alert-category> and <alert-identifier>s
     9.3.  'Alert URN Providers' Registry

There are a few references to these sections that would have to be
renumbered.

Dale