Re: [rfc-i] deprecating relref

No, especially if there’s a graceful migration, as I’d rather not have to update my 10+ I-Ds using <relref>  ;)

I think what I’m missing is that it seems the current <xref> definition has the ability to reference an anchor point in a document already, but maybe not, as the examples in RFC 7991 don’t speak to the case directly...

Assuming a document current has:

    <relref section=‘2.1.4.7' target='I-D.ietf-foobar’/>

    ["I-D.ietf-foobar" is a work-in-progress]

And that Section 2.1.4.7 is defined as:

    <section title=‘The “foo-grouping” Grouping' anchor=‘foo-grouping'>

Would this work, or planned to work?

    <xref target='I-D.ietf-foobar#foo-grouping'>  

PS: It would be an improvement to reference an “anchor”, so that relocations in a base document don’t require a manual update to other documents referencing it.

Thanks,
Kent

> On Apr 26, 2021, at 11:12 AM, Peter Saint-Andre <stpeter@mozilla.com> wrote:
> 
> Hi Kent,
> 
> If (as explained below) the unique attributes of relref were migrated to
> xref, would you still have a separate need for relref?
> 
> Peter
> 
> On 4/23/21 4:48 PM, Kent Watsen wrote:
>> I’m a drive-by tourist here and just noticing this thread, but I’ve been making extensive use of <relref> in my documents.  Enabling authors to link to the specific section in an RFC is very useful.   
>> 
>> Looking into <xref>, I’m guessing that linking to an “anchor” is better because it would automatically update if the linked-section moves, such as when the target document is a work-in-progress - yes?
>> 
>> Kent
>> 
>> 
>> 
>>> On Apr 8, 2021, at 8:20 PM, Peter Saint-Andre <stpeter@mozilla.com> wrote:
>>> 
>>> Hi all,
>>> 
>>> The RFC XML and Style Guide change management team [1] recently
>>> discussed the differences between xref and relref elements [2] and
>>> determined that (a) relref has not been used in source documents
>>> provided by authors and (b) if it had been used, the xml2rfc tool would
>>> have transformed relref to xref while adding any of the attributes
>>> defined in RFC 7991 for relref but not xref (sectionFormat, section,
>>> relative, derivedLink). Therefore our recommendation is to deprecate
>>> relref in 7991bis and likely add some or all of the relref attributes to
>>> xref.
>>> 
>>> Peter
>>> 
>>> [1]
>>> https://mailarchive.ietf.org/arch/msg/rfc-interest/_13Fne0Pxv233coED2BiRY_IJR4/
>>> 
>>> [2] https://github.com/rfc-format/draft-iab-xml2rfc-v3-bis/issues/172
>>> 
>>> _______________________________________________
>>> rfc-interest mailing list
>>> rfc-interest@rfc-editor.org
>>> https://www.rfc-editor.org/mailman/listinfo/rfc-interest
>> 
> _______________________________________________
> rfc-interest mailing list
> rfc-interest@rfc-editor.org
> https://www.rfc-editor.org/mailman/listinfo/rfc-interest