Re: [netmod] document organization

"Acee Lindem (acee)" <acee@cisco.com> Wed, 15 November 2017 09:57 UTC

Return-Path: <acee@cisco.com>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 1E18F1243FE for <netmod@ietfa.amsl.com>; Wed, 15 Nov 2017 01:57:48 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -14.52
X-Spam-Level:
X-Spam-Status: No, score=-14.52 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, SPF_PASS=-0.001, URIBL_BLOCKED=0.001, USER_IN_DEF_DKIM_WL=-7.5] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=cisco.com
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 fF8ZR8uBAXbf for <netmod@ietfa.amsl.com>; Wed, 15 Nov 2017 01:57:46 -0800 (PST)
Received: from alln-iport-8.cisco.com (alln-iport-8.cisco.com [173.37.142.95]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 8C63A124205 for <netmod@ietf.org>; Wed, 15 Nov 2017 01:57:46 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=2074; q=dns/txt; s=iport; t=1510739866; x=1511949466; h=from:to:subject:date:message-id:references:in-reply-to: content-id:content-transfer-encoding:mime-version; bh=pp1k8KeRp771jVdULRGI/uhlTMqf84OTE2jvWLgzJHU=; b=Dkkj6+xZdW8631IuLDbqgCQFB1WUtlrHo93J6j+7nKhK1kUsoZdoc1Ms NIpX3ZEQa0RnLFHTZqeGPwDwKBFTkTOinPMpEs94ZLBg8QCr4zAwK7LyX x+Sw1U1lluDj7eTRt3CC8MfbEwd12qA4bhmciztVe6lRRJ4q/Q88yIyHv s=;
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: A0CpAABpDwxa/5ldJa1dGQEBAQEBAQEBAQEBAQcBAQEBAYM2ZG4nB4N4ih+PIZhXghEKGAuESU8CGoRtPxgBAQEBAQEBAQFrKIUfAgEDAQEhETobAgEIGgImAgICJQsVEAIEARKKJBCqXYInixcBAQEBAQEBAQEBAQEBAQEBAQEbBYEPgiWCB4ZohRiDFYJDIAWiNwKVBJNElgACERkBgTgBHziBdHoVSYJkglwcgWd3h1CBEQEBAQ
X-IronPort-AV: E=Sophos;i="5.44,398,1505779200"; d="scan'208";a="31179163"
Received: from rcdn-core-2.cisco.com ([173.37.93.153]) by alln-iport-8.cisco.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 15 Nov 2017 09:57:32 +0000
Received: from XCH-RTP-013.cisco.com (xch-rtp-013.cisco.com [64.101.220.153]) by rcdn-core-2.cisco.com (8.14.5/8.14.5) with ESMTP id vAF9vWkn020228 (version=TLSv1/SSLv3 cipher=AES256-SHA bits=256 verify=FAIL); Wed, 15 Nov 2017 09:57:32 GMT
Received: from xch-rtp-015.cisco.com (64.101.220.155) by XCH-RTP-013.cisco.com (64.101.220.153) with Microsoft SMTP Server (TLS) id 15.0.1320.4; Wed, 15 Nov 2017 04:57:31 -0500
Received: from xch-rtp-015.cisco.com ([64.101.220.155]) by XCH-RTP-015.cisco.com ([64.101.220.155]) with mapi id 15.00.1320.000; Wed, 15 Nov 2017 04:57:31 -0500
From: "Acee Lindem (acee)" <acee@cisco.com>
To: Ladislav Lhotka <lhotka@nic.cz>, NETMOD WG <netmod@ietf.org>
Thread-Topic: [netmod] document organization
Thread-Index: AQHTXdoXMSrLxtRyWkSNGcNUcFG0VaMVNI4A
Date: Wed, 15 Nov 2017 09:57:31 +0000
Message-ID: <D6317911.D8588%acee@cisco.com>
References: <1510726990.12151.10.camel@nic.cz>
In-Reply-To: <1510726990.12151.10.camel@nic.cz>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
x-ms-exchange-messagesentrepresentingtype: 1
x-ms-exchange-transport-fromentityheader: Hosted
x-originating-ip: [10.24.122.132]
Content-Type: text/plain; charset="utf-8"
Content-ID: <9406C9E3759CCF43A9F0A89D27AE8B53@emea.cisco.com>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/yV1UElE4B1h0124gsorUmx8vaKU>
Subject: Re: [netmod] document organization
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 15 Nov 2017 09:57:48 -0000

Hi Lada, 
If the consensus is not split the document, I think it would be useful to
formally define the “inline” and “uses” options with examples very early.
As it is, there is a brief definition of “inline” but nothing for “uses”
and one must deduct this implicitly.

Thanks,
Acee 

On 11/15/17, 1:23 AM, "netmod on behalf of Ladislav Lhotka"
<netmod-bounces@ietf.org on behalf of lhotka@nic.cz> wrote:

>Hi,
>
>regarding my proposed reorganization of documents: I strongly disagree
>with
>Martin's comment on jabber that it would be a mere split of the contents
>into
>two documents. It is certainly not true because
>
>- we could get rid of the use-schema/inline choice in schema-mounts data:
>the
>inline case needs to state data in the parent tree at all
>
>- there are many CLRs that are relevant only to one of the methods, so
>have to
>distinguish the cases in the text; for example, parent-references don't
>apply to
>"inline"
>
>- (most important for me) the two methods are really two different
>mechanisms,
>and the "inline" method invites various instance-related considerations
>whereas
>"use-schema" doesn't; it's been my experience that people keep confusing
>schema
>construction and instance data mounting.
>
>Lada
>   
>-- 
>Ladislav Lhotka
>Head, CZ.NIC Labs
>PGP Key ID: 0xB8F92B08A9F76C67
>
>_______________________________________________
>netmod mailing list
>netmod@ietf.org
>https://www.ietf.org/mailman/listinfo/netmod