[rfc-i] <seriesInfo>

Julian Reschke julian.reschke at gmx.de
Tue Jul 20 01:03:49 PDT 2021


Am 20.07.2021 um 02:06 schrieb Peter Saint-Andre:
> There's been some confusion about the <seriesInfo> element:
>
> - When <seriesInfo> is a child of <reference>, the 'stream' attribute
> isn't used.
>
> - When <seriesInfo> is a child of <front>, it's unclear how exactly to
> handle the 'stream' attribute. For instance, since <seriesInfo> can
> appear more than once (such as in the case of a BCP), there's potential
> confusion if the values of the 'stream' attribute are inconsistent.
>
> - The 'status' attribute hasn't been used at all.
>
> Based on discussion in the RFC XML and style guide change management
> team, here is a proposal:
>
> 1. Remove 'stream' from <seriesInfo>
>
> 2. Add a new <stream> element as a child of <front>
>
> 3. Remove 'status' from <seriesInfo>
>
> As far as I can see, this would make the use of <seriesInfo> consistent
> whether it is a child of <front> or <reference>.
>
> Feedback is welcome.
> ...

As far as I can tell from a quick check of AUTH48 XML (attached), the
only use of the stream attribute so far was inside the document's front,
and it always replicates the value in /rfc/@submissionType. So what is
it actually for?

If the use case is to augment a *reference* with more data - why hasn't
it be used for that? This really needs a proper design with clear use
cases, and the solution optimally should not ne specific for IETF
documents (hint: there's already <refcontent>).

Best regards, Julian
-------------- next part --------------
8650: IETF (grandparent rfc, @submissionType IETF) 
8651: IETF (grandparent rfc, @submissionType IETF) 
8654: IETF (grandparent rfc, @submissionType IETF) 
8655: IETF (grandparent rfc, @submissionType IETF) 
8660: IETF (grandparent rfc, @submissionType IETF) 
8661: IETF (grandparent rfc, @submissionType IETF) 
8662: IETF (grandparent rfc, @submissionType IETF) 
8663: IETF (grandparent rfc, @submissionType IETF) 
8664: IETF (grandparent rfc, @submissionType IETF) 
8665: IETF (grandparent rfc, @submissionType IETF) 
8666: IETF (grandparent rfc, @submissionType IETF) 
8667: IETF (grandparent rfc, @submissionType IETF) 
8672: independent (grandparent rfc, @submissionType independent) 
8678: IETF (grandparent rfc, @submissionType IETF) 
8679: IETF (grandparent rfc, @submissionType IETF) 
8680: IETF (grandparent rfc, @submissionType IETF) 
8681: IETF (grandparent rfc, @submissionType IETF) 
8682: IETF (grandparent rfc, @submissionType IETF) 
8683: IETF (grandparent rfc, @submissionType IETF) 
8684: IETF (grandparent rfc, @submissionType IETF) 
8686: IETF (grandparent rfc, @submissionType IETF) 
8688: IETF (grandparent rfc, @submissionType IETF) 
8695: IETF (grandparent rfc, @submissionType IETF) 
8705: IETF (grandparent rfc, @submissionType IETF) 
8707: IETF (grandparent rfc, @submissionType IETF) 
8709: IETF (grandparent rfc, @submissionType IETF) 
8711: IETF (grandparent rfc, @submissionType IETF) 
8711: IETF (grandparent rfc, @submissionType IETF) 
8712: IETF (grandparent rfc, @submissionType IETF) 
8713: IETF (grandparent rfc, @submissionType IETF) 
8713: IETF (grandparent rfc, @submissionType IETF) 
8714: IETF (grandparent rfc, @submissionType IETF) 
8714: IETF (grandparent rfc, @submissionType IETF) 
8715: IETF (grandparent rfc, @submissionType IETF) 
8716: IETF (grandparent rfc, @submissionType IETF) 
8716: IETF (grandparent rfc, @submissionType IETF) 
8717: IETF (grandparent rfc, @submissionType IETF) 
8717: IETF (grandparent rfc, @submissionType IETF) 
8718: IETF (grandparent rfc, @submissionType IETF) 
8718: IETF (grandparent rfc, @submissionType IETF) 
8719: IETF (grandparent rfc, @submissionType IETF) 
8719: IETF (grandparent rfc, @submissionType IETF) 
8720: IAB (grandparent rfc, @submissionType IAB) 
8721: IETF (grandparent rfc, @submissionType IETF) 
8722: IAB (grandparent rfc, @submissionType IAB) 
8723: IETF (grandparent rfc, @submissionType IETF) 
8728: IAB (grandparent rfc, @submissionType IAB) 
8729: IAB (grandparent rfc, @submissionType IAB) 
8730: IAB (grandparent rfc, @submissionType IAB) 
8733: IETF (grandparent rfc, @submissionType IETF) 
8735: IETF (grandparent rfc, @submissionType IETF) 
8737: IETF (grandparent rfc, @submissionType IETF) 
8738: IETF (grandparent rfc, @submissionType IETF) 
8742: IETF (grandparent rfc, @submissionType IETF) 
8746: IETF (grandparent rfc, @submissionType IETF) 
8764: independent (grandparent rfc, @submissionType independent) 
8765: IETF (grandparent rfc, @submissionType IETF) 
8767: IETF (grandparent rfc, @submissionType IETF) 
8772: independent (grandparent rfc, @submissionType independent) 
8777: IETF (grandparent rfc, @submissionType IETF) 
8778: IETF (grandparent rfc, @submissionType IETF) 
8779: IETF (grandparent rfc, @submissionType IETF) 
8780: IETF (grandparent rfc, @submissionType IETF) 
8782: IETF (grandparent rfc, @submissionType IETF) 
8783: IETF (grandparent rfc, @submissionType IETF) 
8785: independent (grandparent rfc, @submissionType independent) 
8788: IETF (grandparent rfc, @submissionType IETF) 
8788: IETF (grandparent rfc, @submissionType IETF) 
8792: IETF (grandparent rfc, @submissionType IETF) 
8794: IETF (grandparent rfc, @submissionType IETF) 
8804: IETF (grandparent rfc, @submissionType IETF) 
8808: IETF (grandparent rfc, @submissionType IETF) 
8812: IETF (grandparent rfc, @submissionType IETF) 
8816: IETF (grandparent rfc, @submissionType IETF) 
8819: IETF (grandparent rfc, @submissionType IETF) 
8824: IETF (grandparent rfc, @submissionType IETF) 
8825: IETF (grandparent rfc, @submissionType IETF) 
8826: IETF (grandparent rfc, @submissionType IETF) 
8827: IETF (grandparent rfc, @submissionType IETF) 
8828: IETF (grandparent rfc, @submissionType IETF) 
8829: IETF (grandparent rfc, @submissionType IETF) 
8830: IETF (grandparent rfc, @submissionType IETF) 
8831: IETF (grandparent rfc, @submissionType IETF) 
8832: IETF (grandparent rfc, @submissionType IETF) 
8833: IETF (grandparent rfc, @submissionType IETF) 
8834: IETF (grandparent rfc, @submissionType IETF) 
8835: IETF (grandparent rfc, @submissionType IETF) 
8836: IETF (grandparent rfc, @submissionType IETF) 
8837: IETF (grandparent rfc, @submissionType IETF) 
8838: IETF (grandparent rfc, @submissionType IETF) 
8839: IETF (grandparent rfc, @submissionType IETF) 
8840: IETF (grandparent rfc, @submissionType IETF) 
8841: IETF (grandparent rfc, @submissionType IETF) 
8842: IETF (grandparent rfc, @submissionType IETF) 
8843: IETF (grandparent rfc, @submissionType IETF) 
8844: IETF (grandparent rfc, @submissionType IETF) 
8845: IETF (grandparent rfc, @submissionType IETF) 
8846: IETF (grandparent rfc, @submissionType IETF) 
8847: IETF (grandparent rfc, @submissionType IETF) 
8848: IETF (grandparent rfc, @submissionType IETF) 
8849: IETF (grandparent rfc, @submissionType IETF) 
8850: IETF (grandparent rfc, @submissionType IETF) 
8851: IETF (grandparent rfc, @submissionType IETF) 
8852: IETF (grandparent rfc, @submissionType IETF) 
8853: IETF (grandparent rfc, @submissionType IETF) 
8854: IETF (grandparent rfc, @submissionType IETF) 
8855: IETF (grandparent rfc, @submissionType IETF) 
8856: IETF (grandparent rfc, @submissionType IETF) 
8857: IETF (grandparent rfc, @submissionType IETF) 
8858: IETF (grandparent rfc, @submissionType IETF) 
8859: IETF (grandparent rfc, @submissionType IETF) 
8860: IETF (grandparent rfc, @submissionType IETF) 
8861: IETF (grandparent rfc, @submissionType IETF) 
8862: IETF (grandparent rfc, @submissionType IETF) 
8862: IETF (grandparent rfc, @submissionType IETF) 
8863: IETF (grandparent rfc, @submissionType IETF) 
8864: IETF (grandparent rfc, @submissionType IETF) 
8865: IETF (grandparent rfc, @submissionType IETF) 
8866: IETF (grandparent rfc, @submissionType IETF) 
8867: IETF (grandparent rfc, @submissionType IETF) 
8868: IETF (grandparent rfc, @submissionType IETF) 
8869: IETF (grandparent rfc, @submissionType IETF) 
8870: IETF (grandparent rfc, @submissionType IETF) 
8871: IETF (grandparent rfc, @submissionType IETF) 
8872: IETF (grandparent rfc, @submissionType IETF) 
8873: IETF (grandparent rfc, @submissionType IETF) 
8875: IETF (grandparent rfc, @submissionType IETF) 
8882: IETF (grandparent rfc, @submissionType IETF) 
8885: IETF (grandparent rfc, @submissionType IETF) 
8890: IAB (grandparent rfc, @submissionType IAB) 
8895: IETF (grandparent rfc, @submissionType IETF) 
8909: IETF (grandparent rfc, @submissionType IETF) 
8921: independent (grandparent rfc, @submissionType independent) 
8922: IETF (grandparent rfc, @submissionType IETF) 
8923: IETF (grandparent rfc, @submissionType IETF) 
8928: IETF (grandparent rfc, @submissionType IETF) 
8929: IETF (grandparent rfc, @submissionType IETF) 
8930: IETF (grandparent rfc, @submissionType IETF) 
8931: IETF (grandparent rfc, @submissionType IETF) 
8963: independent (grandparent rfc, @submissionType independent) 
8965: IETF (grandparent rfc, @submissionType IETF) 
8974: IETF (grandparent rfc, @submissionType IETF) 
8978: IETF (grandparent rfc, @submissionType IETF) 
8990: IETF (grandparent rfc, @submissionType IETF) 
8991: IETF (grandparent rfc, @submissionType IETF) 
8992: IETF (grandparent rfc, @submissionType IETF) 
8993: IETF (grandparent rfc, @submissionType IETF) 
8994: IETF (grandparent rfc, @submissionType IETF) 
8995: IETF (grandparent rfc, @submissionType IETF) 
8996: IETF (grandparent rfc, @submissionType IETF) 
8996: IETF (grandparent rfc, @submissionType IETF) 
8997: IETF (grandparent rfc, @submissionType IETF) 
9003: IETF (grandparent rfc, @submissionType IETF) 
9008: IETF (grandparent rfc, @submissionType IETF) 
9013: IETF (grandparent rfc, @submissionType IETF) 
9023: IETF (grandparent rfc, @submissionType IETF) 
9027: IETF (grandparent rfc, @submissionType IETF) 
9030: IETF (grandparent rfc, @submissionType IETF) 
9031: IETF (grandparent rfc, @submissionType IETF) 
9032: IETF (grandparent rfc, @submissionType IETF) 
9033: IETF (grandparent rfc, @submissionType IETF) 
9049: IRTF (grandparent rfc, @submissionType IRTF) 
9057: independent (grandparent rfc, @submissionType independent) 
9082: IETF (grandparent rfc, @submissionType IETF) 
9082: IETF (grandparent rfc, @submissionType IETF) 
9083: IETF (grandparent rfc, @submissionType IETF) 
9083: IETF (grandparent rfc, @submissionType IETF) 
-------------- next part --------------
<xsl:transform xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                version="1.0"
                xmlns:saxon="http://saxon.sf.net/"
                xmlns:saxon-old="http://icl.com/saxon"
>

<xsl:output encoding="UTF-8" omit-xml-declaration="yes" method="text"/>

<xsl:template match="/">
  <xsl:apply-templates select="//seriesInfo/@stream"/>
</xsl:template>

<xsl:template match="@stream">
  <xsl:value-of select="/rfc/@number"/>
  <xsl:text>: </xsl:text>
  <xsl:value-of select="."/>
  <xsl:text> (grandparent </xsl:text>
  <xsl:value-of select="local-name(../../..)"/>
  <xsl:text>, @submissionType </xsl:text>
  <xsl:value-of select="/rfc/@submissionType"/>
  <xsl:text>) </xsl:text>
  <xsl:call-template name="lineno"/>
  <xsl:text>
</xsl:text>
</xsl:template>

<!-- diag support -->
<xsl:template name="lineno">
  <xsl:if test="function-available('saxon-old:line-number')">
    <xsl:if test="saxon-old:line-number() > 0">
      <xsl:text> (at line </xsl:text>
      <xsl:value-of select="saxon-old:line-number()"/>
      <xsl:if test="function-available('saxon-old:systemId')">
        <xsl:variable name="rootsys">
          <xsl:for-each select="/*">
            <xsl:value-of select="saxon-old:systemId()"/>
          </xsl:for-each>
        </xsl:variable>
        <xsl:if test="$rootsys != saxon-old:systemId()">
          <xsl:text> of </xsl:text>
          <xsl:value-of select="saxon-old:systemId()"/>
        </xsl:if>
      </xsl:if>
      <xsl:text>)</xsl:text>
    </xsl:if>
  </xsl:if>
  <xsl:if test="function-available('saxon:line-number')">
    <xsl:if test="saxon:line-number() > 0">
      <xsl:text> (at line </xsl:text>
      <xsl:value-of select="saxon:line-number()"/>
      <xsl:if test="function-available('saxon:systemId')">
        <xsl:variable name="rootsys">
          <xsl:for-each select="/*">
            <xsl:value-of select="saxon:systemId()"/>
          </xsl:for-each>
        </xsl:variable>
        <xsl:if test="$rootsys != saxon:systemId()">
          <xsl:text> of </xsl:text>
          <xsl:value-of select="saxon:systemId()"/>
        </xsl:if>
      </xsl:if>
      <xsl:text>)</xsl:text>
    </xsl:if>
  </xsl:if>
</xsl:template>

</xsl:transform>


More information about the rfc-interest mailing list