Re: [I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft?
I disagree that creating a bis document for terminology changes is a good approach. This means that we are creating a bis document for content that is not inherently part of the framework document! John On Thu, Aug 3, 2017 at 5:24 AM, Susan Hares <sha...@ndzh.com> wrote: > Yoav and Adrian: > > I agree with you that split the terminology is not a good way to go. As a > solution to Yoav's problem, may I suggest the following: > > 1) publish the terminology information in the framework document, > 2) Keep a WG draft for terms that change - this can create a bis document > for the framework document when we have completed all the rest of the work, > > Cheerily, > Sue hares > > -Original Message- > From: Yoav Nir [mailto:ynir.i...@gmail.com] > Sent: Thursday, August 3, 2017 7:27 AM > To: adr...@olddog.co.uk > Cc: 'i2nsf@ietf.org'; draft-ietf-i2nsf-terminol...@ietf.org; 'Kathleen > Moriarty' > Subject: Re: [I2nsf] Is there any objection of merging the content from > draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft? > > Hi, Adrian. > > I tend to agree that splitting the terminology around to several small > documents is not a good way to go. > > I think it should be OK to move the contents into the framework draft, > perhaps as an appendix, with an appropriate paragraph saying that the > terminology in this section is meant for the entire document set of I2NSF > and some of the terms are not used in this (the framework) document. > > There is one potential issue with doing it this way. We intend to get the > framework document published soonish. So if we add the terminology there, > it gets published in an RFC and gets "set in stone". While it's always > possible to add new terms afterwards, it gets messy to change the meaning > of existing terms already defined in the RFC. > > Are we willing to accept this risk/constraint of future work? > > Yoav > > On Thu, 2017-08-03 at 11:18 +0100, Adrian Farrel wrote: > > FWIW, some context. > > > > As we started to advance a number of I2NSF document we ran into a few > problems: > > - Different documents used different terms for similar or identical > > concepts > > - Different documents used the same terms to mean different things > > - Different documents attempted to define the same terms, but actually > introduced > >discrepancies in the definitions > > - Documents started to acquire circular normative dependencies on each > > other > > - Documents made best efforts to duplicate definition text but were not > kept > >up-to-date and in synch > > > > The terminology document was introduced as a way to provide one single > point of reference for all terms and to ensure consistency. > > > > Of course, I don't mind what solution to this purely non-technical > > issue is used so long as it adequately addresses all of the needs. And > > if the IESG has cycles to burn to work out how to publish terminology > > definitions without causing ambiguity or confusion, then it is fine > > with me that they do that (it will keep them from doing harm in the > > technical areas where they might not have the expertise to do the > > right thing :-) > > > > But there are three concerns that I have: > > > > 1. Moving *some* of the definitions from the terminology draft to > another draft will leave behind other terms. That is to say, not all the > terms currently in the terminology draft are currently used in just one > other draft. So there will be an annoying and messy period of working out > where the terms need to be moved to. Alternatively, the whole of the > terminology draft should be subsumed into some other foundational document > notwithstanding that that other document does not use those terms - that > sounds easy, but I bet there will be review comments that say "delete this > term because it is not used in this document." > > > > 2. When new drafts are written there needs to be a central place to go > to find the right term to use to prevent invention of new terms or > re-invention of existing terms. > > > > 3. When a WG or document authors find themselves doing "whatever is > necessary to get a document published" they are making pointless > concessions to the arbitrary rules of Discusses placed on them by the IESG > which risks over-running community consensus. That is, of course, a > socio-political matter, and I don't expect the WG to engage on it, but > individuals who care about the IETF might want to think it through. > > > > I'm not really working on this stuff anymore, so this email really is > only for context and to
Re: [I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft?
I wouldn't want a terminology document that is set in stone, by merging it into the framework document.I don't think the role of the framework document is to be the terminology standard for other documents.The last thing I would want is an argument in that a given effort is out of bounds because the terminology is not in the framework, or the framework terminology is somehow obsolete. I do agree that as the framework document effort preceded the terminology document, we should reconcile the two. On August 3, 2017 at 6:18 AM, Adrian Farrel<adr...@olddog.co.uk>wrote: > FWIW, some context. > > As we started to advance a number of I2NSF document we ran into a few > problems: > - Different documents used different terms for similar or identical concepts > - Different documents used the same terms to mean different things > - Different documents attempted to define the same terms, but actually > introduced > discrepancies in the definitions > - Documents started to acquire circular normative dependencies on each other > - Documents made best efforts to duplicate definition text but were not kept > up-to-date and in synch > > The terminology document was introduced as a way to provide one single point > of reference for all terms and to ensure consistency. > > Of course, I don't mind what solution to this purely non-technical issue is > used so long as it adequately addresses all of the needs. And if the IESG has > cycles to burn to work out how to publish terminology definitions without > causing ambiguity or confusion, then it is fine with me that they do that (it > will keep them from doing harm in the technical areas where they might not > have the expertise to do the right thing :-) > > But there are three concerns that I have: > > 1. Moving *some* of the definitions from the terminology draft to another > draft will leave behind other terms. That is to say, not all the terms > currently in the terminology draft are currently used in just one other > draft. So there will be an annoying and messy period of working out where the > terms need to be moved to. Alternatively, the whole of the terminology draft > should be subsumed into some other foundational document notwithstanding that > that other document does not use those terms - that sounds easy, but I bet > there will be review comments that say "delete this term because it is not > used in this document." > > 2. When new drafts are written there needs to be a central place to go to > find the right term to use to prevent invention of new terms or re-invention > of existing terms. > > 3. When a WG or document authors find themselves doing "whatever is necessary > to get a document published" they are making pointless concessions to the > arbitrary rules of Discusses placed on them by the IESG which risks > over-running community consensus. That is, of course, a socio-political > matter, and I don't expect the WG to engage on it, but individuals who care > about the IETF might want to think it through. > > I'm not really working on this stuff anymore, so this email really is only > for context and to help you understand how we got to where we are. > > Cheers, > Adrian > > > -Original Message- > > From: I2nsf [mailto:i2nsf-boun...@ietf.org] On Behalf Of Kathleen Moriarty > > Sent: 02 August 2017 20:17 > > To: John Strassner > > Cc: i2nsf@ietf.org; draft-ietf-i2nsf-terminol...@ietf.org; draft-ietf-i2nsf- > > framew...@ietf.org; Yoav Nir; Linda Dunbar > > Subject: Re: [I2nsf] Is there any objection of merging the content from > > draft-ietf- > > i2nsf-terminology to draft-ietf-i2nsf-framework draft? > > > > Hi John, > > > > As a standalone document, the terminology draft is a support document. > > The IESG issued the following statement on support documents: > > https://www.ietf.org/iesg/statement/support-documents-in-ietf-wgs.html > > > > I have no problem helping a WG to publish support documents, but would > > like them to think through what they are doing. We typically see > > terminology as part of a main document for a WG and not a draft by > > itself. If it's part of a standards track document (appendix or > > terminology section), then there is no question on it's value. > > > > You may want to take a look at the ballots for the WG documents that > > have gone through the IESG to date and you'll see the types of issues. > > Mainly it is the time/resources spent publishing such documents. I'd > > like to see the terminology published in some document, but not > > necessarily as a stand alone document. > > > > Best regards, > &
Re: [I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft?
Thank you, all for the useful discussion. If the WG (and it seems to) feels strongly about a separate document, we can certainly publish this as a separate document. This discussion was helpful and will be if there is any pushback. Thanks for taking the time to share your thoughts on list. Best regards, Kathleen On Thu, Aug 3, 2017 at 8:43 AM, NetNull <netn...@hushmail.com> wrote: > I wouldn't want a terminology document that is set in stone, by merging it > into the framework document. I don't think the role of the framework > document is to be the terminology standard for other documents. The last > thing I would want is an argument in that a given effort is out of bounds > because the terminology is not in the framework, or the framework > terminology is somehow obsolete. > > I do agree that as the framework document effort preceded the terminology > document, we should reconcile the two. > > > On August 3, 2017 at 6:18 AM, Adrian Farrel <adr...@olddog.co.uk> wrote: > > FWIW, some context. > > As we started to advance a number of I2NSF document we ran into a few > problems: > - Different documents used different terms for similar or identical concepts > - Different documents used the same terms to mean different things > - Different documents attempted to define the same terms, but actually > introduced > discrepancies in the definitions > - Documents started to acquire circular normative dependencies on each other > - Documents made best efforts to duplicate definition text but were not kept > up-to-date and in synch > > The terminology document was introduced as a way to provide one single point > of reference for all terms and to ensure consistency. > > Of course, I don't mind what solution to this purely non-technical issue is > used so long as it adequately addresses all of the needs. And if the IESG > has cycles to burn to work out how to publish terminology definitions > without causing ambiguity or confusion, then it is fine with me that they do > that (it will keep them from doing harm in the technical areas where they > might not have the expertise to do the right thing :-) > > But there are three concerns that I have: > > 1. Moving *some* of the definitions from the terminology draft to another > draft will leave behind other terms. That is to say, not all the terms > currently in the terminology draft are currently used in just one other > draft. So there will be an annoying and messy period of working out where > the terms need to be moved to. Alternatively, the whole of the terminology > draft should be subsumed into some other foundational document > notwithstanding that that other document does not use those terms - that > sounds easy, but I bet there will be review comments that say "delete this > term because it is not used in this document." > > 2. When new drafts are written there needs to be a central place to go to > find the right term to use to prevent invention of new terms or re-invention > of existing terms. > > 3. When a WG or document authors find themselves doing "whatever is > necessary to get a document published" they are making pointless concessions > to the arbitrary rules of Discusses placed on them by the IESG which risks > over-running community consensus. That is, of course, a socio-political > matter, and I don't expect the WG to engage on it, but individuals who care > about the IETF might want to think it through. > > I'm not really working on this stuff anymore, so this email really is only > for context and to help you understand how we got to where we are. > > Cheers, > Adrian > > -Original Message- > From: I2nsf [mailto:i2nsf-boun...@ietf.org] On Behalf Of Kathleen Moriarty > Sent: 02 August 2017 20:17 > To: John Strassner > Cc: i2nsf@ietf.org; draft-ietf-i2nsf-terminol...@ietf.org; draft-ietf-i2nsf- > framew...@ietf.org; Yoav Nir; Linda Dunbar > Subject: Re: [I2nsf] Is there any objection of merging the content from > draft-ietf- > i2nsf-terminology to draft-ietf-i2nsf-framework draft? > > Hi John, > > As a standalone document, the terminology draft is a support document. > The IESG issued the following statement on support documents: > https://www.ietf.org/iesg/statement/support-documents-in-ietf-wgs.html > > I have no problem helping a WG to publish support documents, but would > like them to think through what they are doing. We typically see > terminology as part of a main document for a WG and not a draft by > itself. If it's part of a standards track document (appendix or > terminology section), then there is no question on it's value. > > You may want to take a look at the ballots for the WG documents that > have gone through the IESG to
Re: [I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft?
Hello Sue :) I hope you are well! On 08/03/2017 02:24 PM, Susan Hares wrote: Yoav and Adrian: I agree with you that split the terminology is not a good way to go. As a solution to Yoav's problem, may I suggest the following: 1) publish the terminology information in the framework document, 2) Keep a WG draft for terms that change - this can create a bis document for the framework document when we have completed all the rest of the work, The meta-goal here is to safe "IESG cycles", if I understand it correctly? Is the - eventually inevitable - creation of a bis document less effort than maintaining a separate terminology document? Viele Grüße, Henk Cheerily, Sue hares -Original Message- From: Yoav Nir [mailto:ynir.i...@gmail.com] Sent: Thursday, August 3, 2017 7:27 AM To: adr...@olddog.co.uk Cc: 'i2nsf@ietf.org'; draft-ietf-i2nsf-terminol...@ietf.org; 'Kathleen Moriarty' Subject: Re: [I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft? Hi, Adrian. I tend to agree that splitting the terminology around to several small documents is not a good way to go. I think it should be OK to move the contents into the framework draft, perhaps as an appendix, with an appropriate paragraph saying that the terminology in this section is meant for the entire document set of I2NSF and some of the terms are not used in this (the framework) document. There is one potential issue with doing it this way. We intend to get the framework document published soonish. So if we add the terminology there, it gets published in an RFC and gets "set in stone". While it's always possible to add new terms afterwards, it gets messy to change the meaning of existing terms already defined in the RFC. Are we willing to accept this risk/constraint of future work? Yoav On Thu, 2017-08-03 at 11:18 +0100, Adrian Farrel wrote: FWIW, some context. As we started to advance a number of I2NSF document we ran into a few problems: - Different documents used different terms for similar or identical concepts - Different documents used the same terms to mean different things - Different documents attempted to define the same terms, but actually introduced discrepancies in the definitions - Documents started to acquire circular normative dependencies on each other - Documents made best efforts to duplicate definition text but were not kept up-to-date and in synch The terminology document was introduced as a way to provide one single point of reference for all terms and to ensure consistency. Of course, I don't mind what solution to this purely non-technical issue is used so long as it adequately addresses all of the needs. And if the IESG has cycles to burn to work out how to publish terminology definitions without causing ambiguity or confusion, then it is fine with me that they do that (it will keep them from doing harm in the technical areas where they might not have the expertise to do the right thing :-) But there are three concerns that I have: 1. Moving *some* of the definitions from the terminology draft to another draft will leave behind other terms. That is to say, not all the terms currently in the terminology draft are currently used in just one other draft. So there will be an annoying and messy period of working out where the terms need to be moved to. Alternatively, the whole of the terminology draft should be subsumed into some other foundational document notwithstanding that that other document does not use those terms - that sounds easy, but I bet there will be review comments that say "delete this term because it is not used in this document." 2. When new drafts are written there needs to be a central place to go to find the right term to use to prevent invention of new terms or re-invention of existing terms. 3. When a WG or document authors find themselves doing "whatever is necessary to get a document published" they are making pointless concessions to the arbitrary rules of Discusses placed on them by the IESG which risks over-running community consensus. That is, of course, a socio-political matter, and I don't expect the WG to engage on it, but individuals who care about the IETF might want to think it through. I'm not really working on this stuff anymore, so this email really is only for context and to help you understand how we got to where we are. Cheers, Adrian -Original Message- From: I2nsf [mailto:i2nsf-boun...@ietf.org] On Behalf Of Kathleen Moriarty Sent: 02 August 2017 20:17 To: John Strassner Cc: i2nsf@ietf.org; draft-ietf-i2nsf-terminol...@ietf.org; draft-ietf-i2nsf- framew...@ietf.org; Yoav Nir; Linda Dunbar Subject: Re: [I2nsf] Is there any objection of merging the content from draft-ietf- i2nsf-terminology to draft-ietf-i2nsf-framework draft? Hi John, As a standalone document, the terminology draft is a support document.
Re: [I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft?
Yoav and Adrian: I agree with you that split the terminology is not a good way to go. As a solution to Yoav's problem, may I suggest the following: 1) publish the terminology information in the framework document, 2) Keep a WG draft for terms that change - this can create a bis document for the framework document when we have completed all the rest of the work, Cheerily, Sue hares -Original Message- From: Yoav Nir [mailto:ynir.i...@gmail.com] Sent: Thursday, August 3, 2017 7:27 AM To: adr...@olddog.co.uk Cc: 'i2nsf@ietf.org'; draft-ietf-i2nsf-terminol...@ietf.org; 'Kathleen Moriarty' Subject: Re: [I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft? Hi, Adrian. I tend to agree that splitting the terminology around to several small documents is not a good way to go. I think it should be OK to move the contents into the framework draft, perhaps as an appendix, with an appropriate paragraph saying that the terminology in this section is meant for the entire document set of I2NSF and some of the terms are not used in this (the framework) document. There is one potential issue with doing it this way. We intend to get the framework document published soonish. So if we add the terminology there, it gets published in an RFC and gets "set in stone". While it's always possible to add new terms afterwards, it gets messy to change the meaning of existing terms already defined in the RFC. Are we willing to accept this risk/constraint of future work? Yoav On Thu, 2017-08-03 at 11:18 +0100, Adrian Farrel wrote: > FWIW, some context. > > As we started to advance a number of I2NSF document we ran into a few > problems: > - Different documents used different terms for similar or identical > concepts > - Different documents used the same terms to mean different things > - Different documents attempted to define the same terms, but actually > introduced >discrepancies in the definitions > - Documents started to acquire circular normative dependencies on each > other > - Documents made best efforts to duplicate definition text but were not kept >up-to-date and in synch > > The terminology document was introduced as a way to provide one single point > of reference for all terms and to ensure consistency. > > Of course, I don't mind what solution to this purely non-technical > issue is used so long as it adequately addresses all of the needs. And > if the IESG has cycles to burn to work out how to publish terminology > definitions without causing ambiguity or confusion, then it is fine > with me that they do that (it will keep them from doing harm in the > technical areas where they might not have the expertise to do the > right thing :-) > > But there are three concerns that I have: > > 1. Moving *some* of the definitions from the terminology draft to another > draft will leave behind other terms. That is to say, not all the terms > currently in the terminology draft are currently used in just one other > draft. So there will be an annoying and messy period of working out where the > terms need to be moved to. Alternatively, the whole of the terminology draft > should be subsumed into some other foundational document notwithstanding that > that other document does not use those terms - that sounds easy, but I bet > there will be review comments that say "delete this term because it is not > used in this document." > > 2. When new drafts are written there needs to be a central place to go to > find the right term to use to prevent invention of new terms or re-invention > of existing terms. > > 3. When a WG or document authors find themselves doing "whatever is necessary > to get a document published" they are making pointless concessions to the > arbitrary rules of Discusses placed on them by the IESG which risks > over-running community consensus. That is, of course, a socio-political > matter, and I don't expect the WG to engage on it, but individuals who care > about the IETF might want to think it through. > > I'm not really working on this stuff anymore, so this email really is only > for context and to help you understand how we got to where we are. > > Cheers, > Adrian > > > -Original Message- > > From: I2nsf [mailto:i2nsf-boun...@ietf.org] On Behalf Of Kathleen > > Moriarty > > Sent: 02 August 2017 20:17 > > To: John Strassner > > Cc: i2nsf@ietf.org; draft-ietf-i2nsf-terminol...@ietf.org; > > draft-ietf-i2nsf- framew...@ietf.org; Yoav Nir; Linda Dunbar > > Subject: Re: [I2nsf] Is there any objection of merging the content > > from draft-ietf- i2nsf-terminology to draft-ietf-i2nsf-framework draft? > >
Re: [I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft?
Hi, Adrian. I tend to agree that splitting the terminology around to several small documents is not a good way to go. I think it should be OK to move the contents into the framework draft, perhaps as an appendix, with an appropriate paragraph saying that the terminology in this section is meant for the entire document set of I2NSF and some of the terms are not used in this (the framework) document. There is one potential issue with doing it this way. We intend to get the framework document published soonish. So if we add the terminology there, it gets published in an RFC and gets "set in stone". While it's always possible to add new terms afterwards, it gets messy to change the meaning of existing terms already defined in the RFC. Are we willing to accept this risk/constraint of future work? Yoav On Thu, 2017-08-03 at 11:18 +0100, Adrian Farrel wrote: > FWIW, some context. > > As we started to advance a number of I2NSF document we ran into a few > problems: > - Different documents used different terms for similar or identical concepts > - Different documents used the same terms to mean different things > - Different documents attempted to define the same terms, but actually > introduced >discrepancies in the definitions > - Documents started to acquire circular normative dependencies on each other > - Documents made best efforts to duplicate definition text but were not kept >up-to-date and in synch > > The terminology document was introduced as a way to provide one single point > of reference for all terms and to ensure consistency. > > Of course, I don't mind what solution to this purely non-technical issue is > used so long as it adequately addresses all of the needs. And if the IESG has > cycles to burn to work out how to publish terminology definitions without > causing ambiguity or confusion, then it is fine with me that they do that (it > will keep them from doing harm in the technical areas where they might not > have the expertise to do the right thing :-) > > But there are three concerns that I have: > > 1. Moving *some* of the definitions from the terminology draft to another > draft will leave behind other terms. That is to say, not all the terms > currently in the terminology draft are currently used in just one other > draft. So there will be an annoying and messy period of working out where the > terms need to be moved to. Alternatively, the whole of the terminology draft > should be subsumed into some other foundational document notwithstanding that > that other document does not use those terms - that sounds easy, but I bet > there will be review comments that say "delete this term because it is not > used in this document." > > 2. When new drafts are written there needs to be a central place to go to > find the right term to use to prevent invention of new terms or re-invention > of existing terms. > > 3. When a WG or document authors find themselves doing "whatever is necessary > to get a document published" they are making pointless concessions to the > arbitrary rules of Discusses placed on them by the IESG which risks > over-running community consensus. That is, of course, a socio-political > matter, and I don't expect the WG to engage on it, but individuals who care > about the IETF might want to think it through. > > I'm not really working on this stuff anymore, so this email really is only > for context and to help you understand how we got to where we are. > > Cheers, > Adrian > > > -Original Message- > > From: I2nsf [mailto:i2nsf-boun...@ietf.org] On Behalf Of Kathleen Moriarty > > Sent: 02 August 2017 20:17 > > To: John Strassner > > Cc: i2nsf@ietf.org; draft-ietf-i2nsf-terminol...@ietf.org; draft-ietf-i2nsf- > > framew...@ietf.org; Yoav Nir; Linda Dunbar > > Subject: Re: [I2nsf] Is there any objection of merging the content from > > draft-ietf- > > i2nsf-terminology to draft-ietf-i2nsf-framework draft? > > > > Hi John, > > > > As a standalone document, the terminology draft is a support document. > > The IESG issued the following statement on support documents: > > https://www.ietf.org/iesg/statement/support-documents-in-ietf-wgs.html > > > > I have no problem helping a WG to publish support documents, but would > > like them to think through what they are doing. We typically see > > terminology as part of a main document for a WG and not a draft by > > itself. If it's part of a standards track document (appendix or > > terminology section), then there is no question on it's value. > > > > You may want to take a look at the ballots for the WG documents that > > have gone through
Re: [I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft?
Hello Adrian, some comments inline. On 08/03/2017 12:18 PM, Adrian Farrel wrote: FWIW, some context. As we started to advance a number of I2NSF document we ran into a few problems: - Different documents used different terms for similar or identical concepts - Different documents used the same terms to mean different things - Different documents attempted to define the same terms, but actually introduced discrepancies in the definitions - Documents started to acquire circular normative dependencies on each other - Documents made best efforts to duplicate definition text but were not kept up-to-date and in synch The terminology document was introduced as a way to provide one single point of reference for all terms and to ensure consistency. Personally I think, that is a very elegant way to move forward. Alas, authors of other documents have to start to use the agreed upon terms and by using them also use them in respect to their current definition. Definition of terms MUST NOT be a blocker. If there are terms used in multiple documents and are providing a vital foundation - you cannot change them all the time, over and over again. This also means that authors that need stable terms and want to move on to the really interesting things SHOULD provide input to terminology issues as early as possible, chime in, and also keep in the loop. Otherwise they MUST deal with the definitions as they evolve and are eventually defined, I guess? Of course, I don't mind what solution to this purely non-technical issue is used so long as it adequately addresses all of the needs. And if the IESG has cycles to burn to work out how to publish terminology definitions without causing ambiguity or confusion, then it is fine with me that they do that (it will keep them from doing harm in the technical areas where they might not have the expertise to do the right thing :-) This is an interesting point. What do you think would be the way to move forward that would use the minimal amount of IESG cycles? But there are three concerns that I have: 1. Moving *some* of the definitions from the terminology draft to another draft will leave behind other terms. That is to say, not all the terms currently in the terminology draft are currently used in just one other draft. So there will be an annoying and messy period of working out where the terms need to be moved to. Alternatively, the whole of the terminology draft should be subsumed into some other foundational document notwithstanding that that other document does not use those terms - that sounds easy, but I bet there will be review comments that say "delete this term because it is not used in this document." Splintering the definitions into multiple documents on one hand "solves" a portion of the "overhead problem" of "yet another document", but on the other hand will result in more thresholds for implementors. If one is trying to look up definitions, especially in the initial phase of implementation, this is a frustrating blocker for adopters that I've observed quite often. Merging the definition into a "root" document requires a adequate "root" document that ideally uses and introduces all the terms in normative text, I think. 2. When new drafts are written there needs to be a central place to go to find the right term to use to prevent invention of new terms or re-invention of existing terms. 3. When a WG or document authors find themselves doing "whatever is necessary to get a document published" they are making pointless concessions to the arbitrary rules of Discusses placed on them by the IESG which risks over-running community consensus. That is, of course, a socio-political matter, and I don't expect the WG to engage on it, but individuals who care about the IETF might want to think it through. I'm not really working on this stuff anymore, so this email really is only for context and to help you understand how we got to where we are. Thank you for your input even more so! I try to be not a blocker. If an adequate document that could subsume the terminology can be identified, we should explore the direction. Please note that - in general: - I agree with John's point of view, as stated by him previously. - after certain protocol actions, you are stuck with the definitions in your "root" document -if- you place them there. That can become a real problem (blocker) by itself. Cheers, Adrian Viele Grüße, Henk -Original Message- From: I2nsf [mailto:i2nsf-boun...@ietf.org] On Behalf Of Kathleen Moriarty Sent: 02 August 2017 20:17 To: John Strassner Cc: i2nsf@ietf.org; draft-ietf-i2nsf-terminol...@ietf.org; draft-ietf-i2nsf- framew...@ietf.org; Yoav Nir; Linda Dunbar Subject: Re: [I2nsf] Is there any objection of merging the content from draft-ietf- i2nsf-terminology to draft-ietf-i2nsf-framewor
Re: [I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft?
FWIW, some context. As we started to advance a number of I2NSF document we ran into a few problems: - Different documents used different terms for similar or identical concepts - Different documents used the same terms to mean different things - Different documents attempted to define the same terms, but actually introduced discrepancies in the definitions - Documents started to acquire circular normative dependencies on each other - Documents made best efforts to duplicate definition text but were not kept up-to-date and in synch The terminology document was introduced as a way to provide one single point of reference for all terms and to ensure consistency. Of course, I don't mind what solution to this purely non-technical issue is used so long as it adequately addresses all of the needs. And if the IESG has cycles to burn to work out how to publish terminology definitions without causing ambiguity or confusion, then it is fine with me that they do that (it will keep them from doing harm in the technical areas where they might not have the expertise to do the right thing :-) But there are three concerns that I have: 1. Moving *some* of the definitions from the terminology draft to another draft will leave behind other terms. That is to say, not all the terms currently in the terminology draft are currently used in just one other draft. So there will be an annoying and messy period of working out where the terms need to be moved to. Alternatively, the whole of the terminology draft should be subsumed into some other foundational document notwithstanding that that other document does not use those terms - that sounds easy, but I bet there will be review comments that say "delete this term because it is not used in this document." 2. When new drafts are written there needs to be a central place to go to find the right term to use to prevent invention of new terms or re-invention of existing terms. 3. When a WG or document authors find themselves doing "whatever is necessary to get a document published" they are making pointless concessions to the arbitrary rules of Discusses placed on them by the IESG which risks over-running community consensus. That is, of course, a socio-political matter, and I don't expect the WG to engage on it, but individuals who care about the IETF might want to think it through. I'm not really working on this stuff anymore, so this email really is only for context and to help you understand how we got to where we are. Cheers, Adrian > -Original Message- > From: I2nsf [mailto:i2nsf-boun...@ietf.org] On Behalf Of Kathleen Moriarty > Sent: 02 August 2017 20:17 > To: John Strassner > Cc: i2nsf@ietf.org; draft-ietf-i2nsf-terminol...@ietf.org; draft-ietf-i2nsf- > framew...@ietf.org; Yoav Nir; Linda Dunbar > Subject: Re: [I2nsf] Is there any objection of merging the content from > draft-ietf- > i2nsf-terminology to draft-ietf-i2nsf-framework draft? > > Hi John, > > As a standalone document, the terminology draft is a support document. > The IESG issued the following statement on support documents: > https://www.ietf.org/iesg/statement/support-documents-in-ietf-wgs.html > > I have no problem helping a WG to publish support documents, but would > like them to think through what they are doing. We typically see > terminology as part of a main document for a WG and not a draft by > itself. If it's part of a standards track document (appendix or > terminology section), then there is no question on it's value. > > You may want to take a look at the ballots for the WG documents that > have gone through the IESG to date and you'll see the types of issues. > Mainly it is the time/resources spent publishing such documents. I'd > like to see the terminology published in some document, but not > necessarily as a stand alone document. > > Best regards, > Kathleen > > On Wed, Aug 2, 2017 at 1:51 PM, John Strassner > <john.sc.strass...@huawei.com> wrote: > > I expressed some minor concerns before, and will do so again. > > > > > > > > · What is the reasoning against publishing an INFORMATIONAL RFC for > > terminology? > > > > · Many of the terms in the current terminology draft are not used in > > the framework draft > > > > o This is because the terminology draft was originally conceived to work > > for many diverse subject areas > > > > o The framework draft will not cover some of these diverse subjects in > > detail, and hence, does not need those terms; including them will make the > > reading awkward at best > > > > · Thus, I would recommend > > > > o We keep the current terminology draft until these other subject areas > > mature and have WG-adopted drafts (a possib
Re: [I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft?
Hi John, As a standalone document, the terminology draft is a support document. The IESG issued the following statement on support documents: https://www.ietf.org/iesg/statement/support-documents-in-ietf-wgs.html I have no problem helping a WG to publish support documents, but would like them to think through what they are doing. We typically see terminology as part of a main document for a WG and not a draft by itself. If it's part of a standards track document (appendix or terminology section), then there is no question on it's value. You may want to take a look at the ballots for the WG documents that have gone through the IESG to date and you'll see the types of issues. Mainly it is the time/resources spent publishing such documents. I'd like to see the terminology published in some document, but not necessarily as a stand alone document. Best regards, Kathleen On Wed, Aug 2, 2017 at 1:51 PM, John Strassner <john.sc.strass...@huawei.com> wrote: > I expressed some minor concerns before, and will do so again. > > > > · What is the reasoning against publishing an INFORMATIONAL RFC for > terminology? > > · Many of the terms in the current terminology draft are not used in > the framework draft > > o This is because the terminology draft was originally conceived to work > for many diverse subject areas > > o The framework draft will not cover some of these diverse subjects in > detail, and hence, does not need those terms; including them will make the > reading awkward at best > > · Thus, I would recommend > > o We keep the current terminology draft until these other subject areas > mature and have WG-adopted drafts (a possible alternative is putting them on > the wiki; I am not a big fan of wikis) > > o We move the appropriate terms into appropriate drafts > > § Note: this will cause duplication of terms – yet another reason to keep > the terminology draft > > > > Regards, > > John > > > > From: I2nsf [mailto:i2nsf-boun...@ietf.org] On Behalf Of Linda Dunbar > Sent: Wednesday, August 02, 2017 10:31 AM > To: 'i2nsf@ietf.org' <I2nsf@ietf.org>; draft-ietf-i2nsf-framew...@ietf.org; > draft-ietf-i2nsf-terminol...@ietf.org > Cc: 'Kathleen Moriarty' <kathleen.moriarty.i...@gmail.com>; Yoav Nir > <ynir.i...@gmail.com> > Subject: [I2nsf] Is there any objection of merging the content from > draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft? > > > > I2NSF participants: > > > > During the IETF99 I2NSF Session, our AD Kathleen said that the current IESG > doesn’t like to have RFC for Terminology only drafts. So we should consider > merging the content of Terminology with other drafts. I2NSF framework draft > would be a nature place to have the terminologies. > > > > If you have any objections or concerns of merging the content from > draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft, please > express them to the I2NSF mailing list. > > > > Thanks, Linda & Yoav. > > -- Best regards, Kathleen ___ I2nsf mailing list I2nsf@ietf.org https://www.ietf.org/mailman/listinfo/i2nsf
Re: [I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft?
I expressed some minor concerns before, and will do so again. * What is the reasoning against publishing an INFORMATIONAL RFC for terminology? * Many of the terms in the current terminology draft are not used in the framework draft o This is because the terminology draft was originally conceived to work for many diverse subject areas o The framework draft will not cover some of these diverse subjects in detail, and hence, does not need those terms; including them will make the reading awkward at best * Thus, I would recommend o We keep the current terminology draft until these other subject areas mature and have WG-adopted drafts (a possible alternative is putting them on the wiki; I am not a big fan of wikis) o We move the appropriate terms into appropriate drafts ? Note: this will cause duplication of terms - yet another reason to keep the terminology draft Regards, John From: I2nsf [mailto:i2nsf-boun...@ietf.org] On Behalf Of Linda Dunbar Sent: Wednesday, August 02, 2017 10:31 AM To: 'i2nsf@ietf.org' <I2nsf@ietf.org>; draft-ietf-i2nsf-framew...@ietf.org; draft-ietf-i2nsf-terminol...@ietf.org Cc: 'Kathleen Moriarty' <kathleen.moriarty.i...@gmail.com>; Yoav Nir <ynir.i...@gmail.com> Subject: [I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft? I2NSF participants: During the IETF99 I2NSF Session, our AD Kathleen said that the current IESG doesn't like to have RFC for Terminology only drafts. So we should consider merging the content of Terminology with other drafts. I2NSF framework draft would be a nature place to have the terminologies. If you have any objections or concerns of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft, please express them to the I2NSF mailing list. Thanks, Linda & Yoav. ___ I2nsf mailing list I2nsf@ietf.org https://www.ietf.org/mailman/listinfo/i2nsf
[I2nsf] Is there any objection of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft?
I2NSF participants: During the IETF99 I2NSF Session, our AD Kathleen said that the current IESG doesn't like to have RFC for Terminology only drafts. So we should consider merging the content of Terminology with other drafts. I2NSF framework draft would be a nature place to have the terminologies. If you have any objections or concerns of merging the content from draft-ietf-i2nsf-terminology to draft-ietf-i2nsf-framework draft, please express them to the I2NSF mailing list. Thanks, Linda & Yoav. ___ I2nsf mailing list I2nsf@ietf.org https://www.ietf.org/mailman/listinfo/i2nsf
