Re: [ws-sx] Issue 119: non-normative information in normative part

[NISHIMURA Toshihiro <nishimura.toshi@jp.fujitsu.com>]

I'm pointing out different point from PR003.

PR003 was a request to remove references to non-standard specs.
TC had a consensus that such reference as non-normative reference is
allowed.

This new issue points out non-normative information in normative part
of the specification.
Line 272-274 only provides non-normative information (I hope TC agree
on it).
But the section 2 as a whole is normative except for some parts.
Readers of the specification will misread those non-normative lines as
normative.
There will be some options:
1) Mark Line 272-274 explicitly as non-normative.

2) Move Line 272-274 to non-normative section.

3) Remove Line 272-274

I prefer option 3 because Line 272-274 is not essential to WS-Trust.


Currently I assume the section 2 is normative. But if the section 2 is
non-normative, then there will be another option:
4) Mark section 2 explicitly as non-normative
   with some other changes:
     change "SHOULD" (Line 208) to "should"
     move RFC2246 from normative reference to non-normative reference
     (because RFC2246 only appears in section 2)

---
NISHIMURA Toshihiro (FAMILY Given)
nishimura.toshi@jp.fujitsu.com
STRATEGY AND TECHNOLOGY DIV., SOFTWARE UNIT, FUJITSU LIMITED


At Mon, 27 Nov 2006 15:04:30 -0800,
Marc Goodner wrote:
> 
> I believe the TC already made a decision on the text referred to here for PR issue 3.  I don't agree that we need to remove this text on these grounds.
> 
> -----Original Message-----
> From: Greg Carpenter [mailto:gregcarp@microsoft.com]
> Sent: Monday, November 27, 2006 12:24 PM
> To: NISHIMURA Toshihiro; ws-sx@lists.oasis-open.org
> Subject: [ws-sx] Issue 119: non-normative information in normative part
> 
> Issue 119.
> 
> > -----Original Message-----
> > From: NISHIMURA Toshihiro [mailto:nishimura.toshi@jp.fujitsu.com]
> > Sent: Wednesday, November 22, 2006 4:15 AM
> > To: ws-sx@lists.oasis-open.org
> > Subject: [ws-sx] News issue: non-normative information in
> > normative part
> >
> > Protocol:  ws-trust
> >
> > http://www.oasis-open.org/apps/org/workgroup/ws-sx/download.ph
> > p/21285/ws-trust-1.3-spec-cs-01.pdf
> >
> > Artifact:  spec
> >
> > Type: editorial
> >
> > Title: non-normative information in normative part
> >
> > Description:
> > Section 2 as a whole is normative except for some parts
> > explicitly marked as non-normative (i.e. Line 251 and 306).
> >
> > Line 272-274 (in Section 2) provides just non-normative
> > information (these lines are used only to introduce
> > non-normative WS-Federation spec).
> >
> > There might be cases where non-normative information is used
> > to describe normative portion of spec. But this is not the case.
> > I cann't guess the reason why these lines are necessary here.
> >
> > Proposal:
> > Remove Line 272-274.
> >
> > Related Issues:
> > None
> > ---
> > NISHIMURA Toshihiro (FAMILY Given)
> > nishimura.toshi@jp.fujitsu.com
> > STRATEGY AND TECHNOLOGY DIV., SOFTWARE UNIT, FUJITSU LIMITED