8. Cosa fare nei documenti "bis"

A volte viene pubblicato un RFC che rende obsoleta una precedente edizione dello stesso documento. A volte chiamiamo questi documenti "bis", come quando RFC 4637 deve essere reso obsoleto da draft-ietf-foo-rfc4637bis. Quando il documento originale ha creato registri e/o registrato voci, si pone la questione di come gestire la sezione IANA Considerations nel documento "bis".

Se le registrazioni specificano il documento originale come riferimento, tali registrazioni devono essere aggiornate per puntare alla documentazione corrente (non obsoleta) per quegli elementi. Di solito, ciò significa cambiare il riferimento al documento "bis".

Ci saranno, tuttavia, momenti in cui un documento aggiorna un altro, ma non lo rende obsoleto, e il riferimento definitivo viene modificato per alcuni elementi ma non per altri. Assicurarsi che i riferimenti puntino sempre alla documentazione corretta e attuale per ogni elemento.

Ad esempio, supponiamo che RFC 4637 abbia registrato il flag "BANANA" nel registro "Fruit Access Flags", e che la documentazione per quel flag si trovi nella Sezione 3.2.

Il registro corrente potrebbe apparire, in parte, così:

Name        Description           Reference
--------    -------------------   ---------
BANANA      Flag for bananas      [RFC4637], Section 3.2

Se draft-ietf-foo-rfc4637bis rende obsoleto RFC 4637 e, a causa di una riorganizzazione, ora documenta il flag nella Sezione 4.1.2, la sezione IANA Considerations del documento bis potrebbe contenere un testo come questo:

Si chiede a IANA di modificare le informazioni di registrazione per il flag BANANA nel registro "Fruit Access Flags" come segue:

Name        Description           Reference
--------    -------------------   ---------
BANANA      Flag for bananas      [[this RFC]], Section 4.2.1

In molti casi, se ci sono numerosi riferimenti registrati all'RFC originale e l'organizzazione del documento non ha modificato molto la numerazione delle sezioni registrate, può essere semplicemente ragionevole fare questo:

Poiché questo documento rende obsoleto RFC 4637, si chiede a IANA di modificare tutte le informazioni di registrazione che fanno riferimento a [RFC4637] per fare invece riferimento a [[this RFC]].

Se le informazioni per gli elementi registrati sono state o stanno per essere spostate in altri documenti, allora le informazioni di registrazione dovrebbero essere modificate per puntare a quegli altri documenti. Nella maggior parte dei casi, i riferimenti alla documentazione non dovrebbero essere lasciati puntare al documento obsoleto per registri o elementi registrati che sono ancora in uso corrente. Per registri o elementi registrati che non sono più in uso corrente, di solito avrà senso lasciare i riferimenti puntare al vecchio documento -- l'ultimo riferimento corrente per gli elementi obsoleti. Il punto principale è assicurarsi che i puntatori di riferimento siano il più utili e attuali possibile in modo ragionevole, e gli autori dovrebbero considerare ciò mentre scrivono le IANA Considerations per il nuovo documento. Come sempre: fare la cosa giusta, e c'è flessibilità per permetterlo.

È estremamente importante essere chiari nelle istruzioni riguardanti l'aggiornamento dei riferimenti, specialmente nei casi in cui alcuni riferimenti devono essere aggiornati e altri no.