7. Références de Documentation dans les Registres IANA
Habituellement, les registres et les entrées de registre incluent des références à de la documentation (RFC ou autres documents). Le but de ces références est de fournir aux implémenteurs des pointeurs pour trouver les détails nécessaires à l'implémentation, NON pas simplement de noter quel document a créé le registre ou l'entrée. Par conséquent :
-
Si un document enregistre un élément qui est défini et expliqué ailleurs, la référence enregistrée doit pointer vers le document contenant la définition, et non vers le document qui effectue simplement l'enregistrement.
-
Si l'élément enregistré est défini et expliqué dans le document actuel, il est important d'inclure suffisamment d'informations pour permettre aux implémenteurs de comprendre l'élément et de créer une implémentation appropriée.
-
Si l'élément enregistré est expliqué principalement dans une section spécifique du document de référence, il est utile d'inclure une référence de section. Par exemple, "[RFC4637], Section 3.2", plutôt que simplement "[RFC4637]".
-
Pour la documentation d'un nouveau registre, la référence doit fournir des informations sur le registre lui-même, et non pas seulement un pointeur vers sa création. Les informations utiles incluent l'objectif du registre, une justification de sa création, la documentation du processus et de la politique pour les nouveaux enregistrements, des directives pour les nouveaux enregistrants ou les experts désignés, ainsi que d'autres informations connexes. Notez cependant que, bien qu'il soit important d'inclure ces informations dans le document, elles ne doivent pas toutes figurer dans la section IANA Considerations. Voir Section 1.1.