/[suikacvs]/webroot/www/2004/id/draft-ietf-http-feature-reg-00.txt
Suika

Contents of /webroot/www/2004/id/draft-ietf-http-feature-reg-00.txt

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.1 - (hide annotations) (download)
Tue Jun 15 08:04:04 2004 UTC (20 years, 10 months ago) by wakaba
Branch: MAIN
CVS Tags: HEAD
File MIME type: text/plain
New

1 wakaba 1.1
2     HTTP Working Group Koen Holtman, TUE
3     Internet-Draft Andrew Mutz, Hewlett-Packard
4     Expires: April 30, 1997 October 30, 1996
5    
6    
7     Feature Tag Registration Procedures
8    
9     draft-ietf-http-feature-reg-00.txt
10    
11    
12     STATUS OF THIS MEMO
13    
14     This document is an Internet-Draft. Internet-Drafts are
15     working documents of the Internet Engineering Task Force
16     (IETF), its areas, and its working groups. Note that other
17     groups may also distribute working documents as
18     Internet-Drafts.
19    
20     Internet-Drafts are draft documents valid for a maximum of
21     six months and may be updated, replaced, or obsoleted by
22     other documents at any time. It is inappropriate to use
23     Internet-Drafts as reference material or to cite them other
24     than as "work in progress".
25    
26     To learn the current status of any Internet-Draft, please
27     check the "1id-abstracts.txt" listing contained in the
28     Internet-Drafts Shadow Directories on ftp.is.co.za
29     (Africa), nic.nordu.net (Europe), munnari.oz.au (Pacific
30     Rim), ds.internic.net (US East Coast), or ftp.isi.edu (US
31     West Coast).
32    
33     Distribution of this document is unlimited. Please send
34     comments to the HTTP working group at
35     <http-wg@cuckoo.hpl.hp.com>. Discussions of the working
36     group are archived at
37     <URL:http://www.ics.uci.edu/pub/ietf/http/>. General
38     discussions about HTTP and the applications which use HTTP
39     should take place on the <www-talk@w3.org> mailing list.
40    
41     This draft is part of a document set about transparent content
42     negotiation in HTTP. See
43     <URL:http://gewis.win.tue.nl/~koen/conneg/> for related
44     documents.
45    
46    
47     ABSTRACT
48    
49     The internet draft draft-holtman-http-negotiation-03.txt
50     (Transparent Content Negotiation in HTTP) specifies a `feature
51     negotiation' mechanism for negotiation on content characteristics
52     other than MIME type, charset, and language. Feature negotiation
53     allows the quick introduction of new dimensions of negotiation
54     through the registration of `feature tags'. A feature tag
55     identifies a capability of a user agent or a preference of a user.
56    
57     This document discusses considerations related to feature tag
58     registration, and contains a proposed definition of a feature tag
59     registration procedure. Feature tag registration is foreseen as an
60     ongoing, open process. It should keep pace with the introduction
61     of new rendering features by web software vendors, and other
62     parties such as standards bodies.
63    
64    
65     TABLE OF CONTENTS
66    
67     1 Introduction
68    
69     2 Background and design considerations
70     2.1 Purpose of feature negotiation
71     2.2 Parties who would want to register feature tags
72     2.3 Feature tag registration timeline
73     2.4 Volume considerations
74     2.5 The IANA
75     2.6 Potential problems of a review-less registration process
76     2.6.1 Excessive registration, trademark fights
77     2.6.2 Intentional misregistration
78     2.7 Partitioning the feature tag name-space
79    
80     3 Feature tag registration
81     3.1 Registration trees
82     3.1.1 IETF tree
83     3.1.2 Global tree
84     3.1.3 Local or specialized tree
85     3.1.4 Special `x.' tree
86     3.1.5 Additional registration trees
87     3.2 Registration requirements
88     3.2.1 Functionality requirement
89     3.2.2 Naming requirements
90     3.2.3 Specification requirements
91     3.2.4 Security requirements
92     3.2.5 Publication requirements
93    
94     3.3 Registration procedure
95     3.3.1 Present the feature tag to the community for review
96     3.3.2 IESG approval
97     3.3.3 IANA registration
98     3.3.4 Delayed publication
99    
100     3.4 Comments on feature tag registrations
101     3.5 Location of registered feature tag list
102     3.6 IANA procedures for registering feature tags
103     3.7 Change control
104     3.8 Registration template
105    
106     4 Acknowledgments
107    
108     5 References
109    
110     6 Author's address
111    
112     Appendix A: Feature tag summaries
113    
114     Appendix B: IANA and RFC editor to-do list
115    
116    
117     1 Introduction
118    
119     The internet draft draft-holtman-http-negotiation-03.txt
120     (Transparent Content Negotiation in HTTP) specifies a `feature
121     negotiation' mechanism for negotiation on content characteristics
122     other than MIME type, charset, and language. Feature negotiation
123     allows the quick introduction of new dimensions of negotiation
124     through the registration of `feature tags'. A feature tag
125     identifies a capability of a user agent or a preference of a user.
126    
127     This document discusses considerations related to feature tag
128     registration, and contains a proposed definition of a feature tag
129     registration procedure. Feature tag registration is foreseen as an
130     ongoing, open process which will keep pace with the introduction
131     of new rendering features by web software vendors, and other
132     parties such as standards bodies.
133    
134     Section 2 discusses considerations related to feature tag
135     registration. Section 3 contains a proposed definition of a
136     feature tag registration procedure.
137    
138    
139     2 Background and design considerations
140    
141     This section provides background material related to the design of
142     the feature tag registration procedures. It does not contain any
143     normative material. This section will be deleted or moved to an
144     appendix in the final version of this document.
145    
146     See Section 4 of [2] for an overview of transparent content
147     negotiation and feature negotiation. Section 7 of [2] contains
148     some examples of the use of feature tags. Section 6 of [2] covers
149     the technical aspects of feature negotiation mechanism. This
150     document supersedes Section 8 (Feature tag registration) of [2].
151    
152     For examples of registration procedures, see [3].
153    
154    
155     2.1 Purpose of feature negotiation
156    
157     The feature negotiation mechanism of transparent content
158     negotiation [2] is intended to provide a better alternative to
159     content negotiation based on the user-agent field. User-agent
160     negotiation has many disadvantages: it is cache-unfriendly,
161     difficult to maintain, and significant time is required to keep up
162     with new user agent releases.
163    
164     The main advantage of user-agent based negotiation is that it can be
165     used immediately after a user agent with a new feature is released,
166     without waiting for any standardization actions. This
167     advantage should be retained in feature negotiation. If the
168     content creation community can't use feature negotiation to
169     negotiate on the new hot feature of the week, feature negotiation
170     will not succeed in supplanting user-agent based negotiation.
171    
172     Therefore the registration of tags related to browser or browser
173     component features needs to be a very fast process. It must be
174     possible to register feature tags in parallel with the release of a
175     new browser alpha version.
176    
177    
178     2.2 Parties who would want to register feature tags
179    
180     Feature negotiation allows the quick introduction of new dimensions
181     of negotiation through the registration of `feature tags'. The
182     following parties might want to introduce new dimensions of
183     negotiation:
184    
185     1. Browser and browser component vendors, when inventing and
186     implementing new features or components.
187    
188     2. The IETF or some other standards body, when creating a new
189     standard for a content format, or when identifying a new type
190     of user preference (for example a preference for
191     representations without animated gifs).
192    
193     3. Content authors, when identifying a new type of user
194     preference and creating variants to match.
195    
196     Note that if (some) users can configure their browsers to identify
197     new feature tags, the introduction of new preferences does
198     not require the updating of browser software.
199    
200     A fast registration process is mainly needed for registration by
201     group 1 and 3. For 2, a slower process would suffice. Thus, one
202     could create separate registration subtrees for these groups, with
203     no review for 1 and 3, and some review for 2.
204    
205    
206     2.3 Feature tag registration timeline
207    
208     This is a timeline for the registration of a feature tag which
209     succeeds in being generally used.
210    
211     Time Action
212     (months)
213    
214     t+0 Browser vendor A invents the new feature XY.
215    
216     t+1 Vendor A starts implementing XY, and writes a
217     feature tag registration form for the `xy' tag.
218    
219     t+2 Vendor A submits the form and the IANA registers the `xy'
220     feature tag.
221    
222     t+2.1 Vendor A releases a new browser version, which
223     a) implements the feature XY
224     b) has the `xy' tag present when doing feature negotiation.
225    
226     t+2.5 `Early adopter' content authors start making variants
227     which use XY.
228    
229     t+3 Vendor B starts implementing XY in their own browser.
230    
231     t+3 The `xy' tag appears in lists of useful tags maintained by
232     third parties.
233    
234     t+3.5 Vendor B releases a new browser version, which
235     a) implements the feature XY
236     b) has the `xy' tag present when doing feature negotiation.
237    
238     t+3.5 Many content authors start making variants which use XY.
239    
240     t+4 Vendor C starts implementing XY, and invents the extension
241     XY_COLOR.
242    
243     t+4.5 Vendor C registers the `xy_color' feature tag.
244    
245     t+4.5 Vendor C releases a new browser version, which
246     a) implements the features XY and XY_COLOR
247     b) has the `xy' and `xy_color' tags present when doing
248     feature negotiation.
249    
250     t+10 90% of all deployed browsers support XY. Content authors
251     start using XY it without bothering to provide an alternate
252     representation.
253    
254    
255     2.4 Volume considerations
256    
257     In order to be effective at replacing user-agent negotiation,
258     feature tag registration which will have to keep pace with the
259     introduction of new rendering features by web software vendors.
260    
261     As vendors are moving fast, this inevitably leads to a feature tag
262     name-space which contains a lot of tags. Also, a lot of tags
263     will be `dead' tags, tags related to features which failed to take
264     off and gain widespread use. Compare this to the situation in the
265     USENET newsgroup name-space.
266    
267     A list of _all_ registered feature tags will therefore generally be
268     too long to be useful to any content author. Third parties could
269     filter the feature tag name-space and compile short lists of useful
270     tags. Web indexing robots could, while traversing the web, gather
271     statistics about actual use of feature tags; these statistics could
272     help in compiling lists.
273    
274     This filtering after registration basically follows the HTML 3.2
275     model of creating order _after_ the marketplace battles have died
276     down.
277    
278    
279     2.5 The IANA
280    
281     With the MIME registration procedures being updated (see [3]),
282     there has been some confusion over what the IANA will register.
283     Jon Postel recently told us that:
284    
285     The IANA is pretty good at keeping lists. It is not so good at
286     evaluating the merits (or lack thereof) of the requests to add
287     things to lists. [...] So, yes the IANA would keep the list of
288     "feature tags" provided that that there is either a very simple
289     way to decide if requests pass muster, or a designated someone
290     else will be available to make that decision.
291    
292     So two types of registration name-spaces can be created:
293    
294     a) a space with feature tag review process performed by the IETF
295    
296     b) a space with very basic registration rules which do not take
297     the merit of the feature tag into account. To quote [3],
298     this type of registration "does not imply endorsement,
299     approval, or recommendation by the IANA or IETF or even
300     certification that the specification is adequate."
301    
302     For features introduced by browser and browser component vendors, a
303     space with a type b) registration process seems necessary, if only
304     because the IETF does not have the manpower required for a review
305     process which would meet the speed and volume requirements.
306    
307    
308     2.6 Potential problems of a review-less registration process
309    
310     Several potential problems connected to having a registration
311     process without review have been identified. These are covered in
312     the subsections below.
313    
314    
315     2.6.1 Excessive registration, trademark fights
316    
317     One danger is excessive registration as seen in the internet domain
318     name-space.
319    
320     We speculate that the various forces which contributed to the
321     domain name registration problems are absent for feature tags:
322     feature tags will not be very visible to end users, and
323     registration of a feature tag does not mean you get exclusive use.
324    
325     Therefore we do not expect excessive registration to occur. Of
326     course it is possible to update the registration procedure if
327     excessive registration _does_ occur. A necessary precaution is to
328     reserve a part of the feature tag name-space for future use.
329    
330     As an a-priori safeguard, the IANA could be allowed to reject
331     registrations which are `obviously bogus', and be allowed to reject
332     or delay the registration of `large collections of tags with
333     questionable value'. Such decisions could be appealed to the IESG.
334    
335     Note however that the danger of excessive registration is also
336     present in the vendor and personal spaces of [3], and that [3] does
337     not specify such safeguards.
338    
339    
340     2.6.2 Intentional misregistration
341    
342     Vendor X could try to pre-emptively block the development of a
343     `walking gifs' feature by other vendors by registering a
344     `walking_gifs' feature tag which refers to some bogus capability or
345     preference.
346    
347     However, we feel that the English language is flexible enough to
348     allow the invention of alternative tags to label a real `walking
349     gifs' feature, if ever developed.
350    
351     Also, the registration rules could allow the IANA to reject
352     registration `if the tag name is clearly bogus or misleading'. The
353     rejection would have to include a suggestion for a tag name which
354     _would_ be acceptable.
355    
356     In addition the registration process does mandate a description of
357     the feature in some detail.
358    
359    
360     2.7 Partitioning the feature tag name-space
361    
362     A partitioning of the feature tag name-space (for example through
363     the definition of a standard prefix naming scheme) can help to keep
364     the tag registry manageable. The partitioning could be based on
365     several criteria, or combinations thereof:
366    
367     a) who registered the tag ( ietf / vendor / other )
368    
369     b) the intended scope ( global / local / personal / experimental )
370    
371     c) the area of negotiation:
372     - capability / preference
373     - related to HTML / not related to HTML
374     - specific to one MIME type / not MIME type specific
375     - for static content / for dynamic content
376     - etc.
377    
378     The options for partitioning have not been carefully explored yet,
379     much work still needs to be done in this area. In particular, it
380     is not yet clear whether a useful partitioning based on c) can be
381     found.
382    
383    
384     3 Feature tag registration
385    
386     [##Note: This section is a proposal only. Much of the text in this
387     section was taken from [3]. Though this section tentatively
388     introduces a 4-way top level partitioning of the feature tag
389     name-space, it does not discuss any sub-partitioning yet.##]
390    
391     Registration of a new feature tag starts with the construction of a
392     registration proposal. Registration may occur in several different
393     registration trees, which have different requirements as discussed
394     below. The following sections describe the requirements and
395     procedures used for each of the different registration trees.
396    
397    
398     3.1 Registration trees
399    
400     The following subsections define registration "trees",
401     distinguished by the use of faceted names (e.g., names of the form
402     "tree.feature_name").
403    
404    
405     3.1.1 IETF tree
406    
407     The IETF tree is intended for feature tags of general interest to
408     the Internet Community. Registration in the IETF tree requires
409     approval by the IESG and publication of the feature tag
410     specification as some form of RFC.
411    
412     Feature tags in the IETF tree normally have names that are not
413     explicitly faceted, i.e., do not contain period (".", full stop)
414     characters.
415    
416     The "owner" of a feature tag in the IETF tree is assumed to be the
417     IETF itself. Modification or alteration of the specification
418     requires the same level of processing (e.g. standards track)
419     required for the initial registration.
420    
421    
422     3.1.2 Global tree
423    
424     The global tree is intended for feature tags of general interest to
425     the Internet Community. Unlike registration in the IETF tree,
426     registration in the global tree does not require approval by the
427     IESG. A registration may be placed in the global tree by anyone
428     who has the need to allow for feature negotiation on a particular
429     capability or preference.
430    
431     Typically, if a web browser vendor or browser component vendor
432     introduces a new feature to the Internet Community, and if it is
433     meaningful to do feature negotiation on it, the vendor can register
434     a feature tag in the global tree.
435    
436     The owner of "global" tags and associated specifications is the
437     person or entity making the registration, or one to whom
438     responsibility has been transferred as described below.
439    
440     Tags in the global tree will be distinguished by the leading facet
441     "g.". While public exposure and review of feature tags to be
442     registered in the global tree is not required, using the
443     ietf-feature-tags list for review is strongly encouraged to improve
444     the quality of those specifications. Registrations in the global
445     tree may be submitted directly to the IANA.
446    
447     [##Note: the name `global' for this tree is only a proposal. It
448     could be called the World-wide tree to get a "w." leading facet.##]
449    
450    
451     3.1.3 Local or specialized tree
452    
453     The local tree is intended for feature tags meant to label
454     capabilities or preferences which are relevant in a localized,
455     specialized, restricted, or experimental context.
456    
457     Variant data which is accessible to the whole Internet Community,
458     but usable only with locally extended browsing software, is
459     typically labeled with tags in the local tree.
460    
461     The owner of "local" tags and associated specifications is the
462     person or entity making the registration, or one to whom
463     responsibility has been transferred as described below.
464    
465     Tags in the local tree will be distinguished by the leading facet
466     "l.". While public exposure and review of feature tags to be
467     registered in the local tree is not required, using the
468     ietf-feature-tags list for review is strongly encouraged to improve
469     the quality of those specifications. Registrations in the local
470     tree may be submitted directly to the IANA.
471    
472    
473     3.1.4 Special `x.' tree
474    
475     Feature tags with "x." as the first facet are reserved for use in
476     experimental contexts. These tags are unregistered, experimental,
477     and should be used only with the active agreement of the parties
478     exchanging them.
479    
480     With the low-barrier registration procedures described above for
481     global and local trees, it should rarely, if ever, be necessary to
482     use experimental tags, and as such use of these tags is
483     discouraged.
484    
485    
486     3.1.5 Additional registration trees
487    
488     From time to time and as required by the community, the IANA may,
489     with the advice and consent of the IESG, create new top-level
490     registration trees. Establishment of these new trees will be
491     announced through RFC publication approved by the IESG.
492    
493    
494     3.2 Registration requirements
495    
496     Feature tag registration proposals are all expected to conform
497     to various requirements laid out in the following sections.
498    
499    
500     3.2.1 Functionality requirement
501    
502     A feature tag must function as an actual feature negotiation
503     capability or preference indicator. A feature tag must never
504     indicate a property of a representation, but must indicate the
505     capability to handle a property of a representation, or the
506     preference for property of a representation.
507    
508     A feature tag may not simply reproduce the negotiation
509     functionality of the existing standardized HTTP negotiation
510     dimensions mentioned in Section 4.6 of [2]. In particular, media
511     types, character sets, transfer encodings, and languages may not be
512     registered as feature tags.
513    
514     Sub-properties of media types, character sets, and languages may be
515     registered as feature tags, because in [2], negotiation on such
516     sub-properties is often only viable within the feature negotiation
517     framework. The power of media type parameter negotiation in [2] is
518     very limited. Therefore, whenever powerful negotiation on a
519     sub-property of a media type is desirable, registration of a
520     feature tag for this sub-property is allowed even if it can also be
521     expressed as a media type parameter.
522    
523     [##Question to be resolved: Content negotiation allows a primitive
524     form of negotiation on HTTP protocol extensions, by offering a
525     choice between a variant which is transferred using the protocol
526     extension, and a variant without it. The planned PEP standard will
527     offer a much more powerful and scalable form of negotiation in this
528     area. The wide-spread use of feature negotiation to negotiate on
529     protocol extensions could be harmful to caching. Should the
530     registration of feature tags which intend to allow for negotiation
531     on HTTP protocol extensions therefore be disallowed? Or should
532     part of the feature tag name-space be reserved to mirror the
533     information which is normally conveyed through PEP?##]
534    
535    
536     3.2.2 Naming requirements
537    
538     All feature tag names must be unique, and must conform to the HTTP
539     token syntax [1].
540    
541     Any predefined feature tag values and any defined tag value formats
542     must also conform to the HTTP token syntax [1].
543    
544     The IANA may reject tag names which are obviously bogus or
545     misleading. The rejection has to include a suggestion for a tag
546     name which would be acceptable. Note however that other than in
547     the IETF tree, the acceptance of a feature tag does not imply
548     certification that the tag is adequately named.
549    
550    
551     3.2.3 Specification requirements
552    
553     For feature tags which indicate a preference, a precise and openly
554     available specification of the preference is required, and must at
555     a minimum be referenced by, if it isn't actually included in, the
556     feature tag registration proposal itself.
557    
558     For feature tags registered in the IETF tree which indicate a
559     capability, a precise and openly available specification of the
560     capability is required. It must at a minimum be referenced by (if
561     not actually included in) the feature tag registration
562     proposal itself.
563    
564     For feature tags in the global and local trees which indicate a
565     capability, an openly available description of the capability is
566     minimally required. The specification of detailed syntax and
567     processing particulars need not be publicly available. Such
568     registration proposals are explicitly permitted to include a
569     specification of which software and version (first) implements the
570     indicated capability. References to or inclusion of specifications
571     in these registration proposals is encouraged but not required.
572    
573     The registration of feature tags referencing patented technology is
574     specifically permitted. However the restrictions set forth in RFC
575     1602 on the use of patented technology in standards-track protocols
576     must be respected when the specification of a feature tag is part
577     of a standards-track protocol.
578    
579    
580     3.2.4 Security requirements
581    
582     An analysis of security issues is required for all tags
583     registered in the IETF tree. (This is in accordance with the basic
584     requirements for all IETF protocols.) A similar analysis for
585     feature tags registered in the global or local trees is encouraged
586     but not required. All descriptions of security issues must
587     be as accurate as possible regardless of registration tree. In
588     particular, a statement that there are "no security issues
589     associated with the indicated feature" must not be confused with
590     "the security issues associates with this feature have not been
591     assessed".
592    
593     There is absolutely no requirement that feature tags registered
594     in any tree be secure or completely free from risks.
595     Nevertheless, all known security risks must be identified in
596     the registration of a feature tag, again regardless of
597     registration tree.
598    
599     The security considerations section of all registrations is subject
600     to continuing evaluation and modification, and in particular may be
601     extended by use of the "comments on feature tags" mechanism
602     described in subsequent sections.
603    
604    
605     3.2.5 Publication requirements
606    
607     Proposals for feature tags registered in the IETF tree must be
608     published as RFCs. RFC publication of global and local feature tag
609     proposals is not required. In all cases the IANA will retain
610     copies of all feature tag proposals and "publish" them as part of
611     the feature tag registration tree itself.
612    
613     Other than in the IETF tree, the registration of a feature tag does
614     not imply endorsement, approval, or recommendation by the IANA or
615     the IETF or even certification that the specification is adequate.
616    
617     It is neither possible nor necessary for the IANA to conduct a
618     comprehensive review of feature tag registrations. Nevertheless,
619     the IANA has the authority to identify obviously incompetent
620     material and exclude it.
621    
622    
623     3.3 Registration procedure
624    
625     The following procedure has been implemented by the IANA for review
626     and approval of new feature tags. This is not a formal standards
627     process, but rather an administrative procedure intended to allow
628     the fast creation of negotiation capabilities for newly introduced
629     features.
630    
631     For registration in the IETF tree, the normal IETF processes should
632     be followed. Posting of an internet-draft and announcement
633     on the ietf-feature-tags list (as described in the next subsection)
634     is a first step. For registrations in the global or local trees,
635     the initial review step described below may be omitted and the tag
636     registered directly by submitting the template and an explanation
637     to the IANA (at iana@isi.edu). However, authors of global or local
638     feature tag specifications are encouraged to seek community review
639     and comment whenever that is feasible.
640    
641    
642     3.3.1 Present the feature tag to the community for review
643    
644     Send a proposed feature tag registration to the
645     "ietf-feature-tags@iana.org" mailing list for a two week review
646     period. This mailing list has been established for the purpose of
647     reviewing proposed feature tags. Proposed feature tags are not
648     formally registered and must not be used; the "x." prefix can be
649     used until registration is complete.
650    
651     The intent of the public posting is to solicit comments and
652     feedback on the choice of tag name, the clarity of the tag
653     specification, and a review of any security considerations. The
654     submitter may submit a revised registration proposal, or withdraw
655     the registration proposal completely, at any time.
656    
657    
658     3.3.2 IESG approval
659    
660     Feature tags registered in the IETF tree must be submitted to
661     the IESG for approval.
662    
663    
664     3.3.3 IANA registration
665    
666     Provided that the proposed tag meets the requirements for feature
667     tags and has obtained whatever approval is necessary, the
668     author may submit the registration request to the IANA, which
669     will register the feature tag and make the feature tag
670     registration available to the community.
671    
672    
673     3.3.4 Delayed publication
674    
675     By default, feature tag registration proposals are published by the
676     IANA immediately after registration of the tag.
677    
678     In some situations, a software vendor may not wish that a
679     specification of a tag for a planned new feature is published
680     before the date at which the software implementing this feature is
681     released to the Internet Community. Therefore, when submitting a
682     feature tag registration proposal for a planned feature, a vendor
683     may request a publication delay of up to four weeks after
684     registration of the tag by the IANA.
685    
686     Immediately after receiving a notification of registration from the
687     IANA, the vendor may release software which recognizes the tag to
688     the Internet Community, and make public the tag specification
689     though his own channels.
690    
691    
692     3.4 Comments on feature tag registrations
693    
694     Comments on registered feature tags may be submitted by members of
695     the community to the IANA. These comments will be passed on to the
696     "owner" of the feature tag if possible. Submitters of comments may
697     request that their comment be attached to the feature tag
698     registration itself, and if the IANA approves of this the comment
699     will be made accessible in conjunction with the tag registration
700     itself.
701    
702    
703     3.5 Location of registered feature tag list
704    
705     Feature tag registrations will be posted in the anonymous FTP
706     directory "ftp://ftp.isi.edu/in-notes/iana/assignments/feature-
707     tags/" and all registered feature tags will be listed in the
708     periodically issued "Assigned Numbers" RFC [currently RFC- 1700].
709     The feature tag description and other supporting material may also
710     be published as an Informational RFC by sending it to
711     "rfc-editor@isi.edu" (please follow the instructions to RFC authors
712     [RFC-1543]).
713    
714    
715     3.6 IANA procedures for registering feature tags
716    
717     The IANA will only register feature tags in the IETF tree in
718     response to a communication from the IESG stating that a given
719     registration has been approved.
720    
721     Global and local tags will be registered by the IANA automatically
722     and without any formal review as long as the following minimal
723     conditions are met:
724    
725     (1) Feature tags must indicate an actual feature negotiation
726     capability or preference.
727    
728     (2) All feature tag names must be unique, and must conform to the
729     HTTP token syntax. Any predefined feature tag values and
730     any defined tag value formats must also conform to the HTTP
731     token syntax.
732    
733     (3) For feature tags which indicate a preference, a precise and
734     openly available specification of the preference is
735     required. For feature tags which indicate a capability, an
736     openly available description of the capability is minimally
737     required.
738    
739     (4) Any security considerations given must not be obviously
740     bogus. (It is neither possible nor necessary for the
741     IANA to conduct a comprehensive security review of
742     feature tag registrations. Nevertheless, the IANA has
743     the authority to identify obviously incompetent material
744     and exclude it.)
745    
746    
747     3.7 Change control
748    
749     Once a feature tag has been published by the IANA, the owner may
750     request a change to its definition. The change request follows the
751     following procedure:
752    
753     (1) Publish the revised template on the ietf-feature-tags list.
754    
755     (2) Leave at least two weeks for comments.
756    
757     (3) Publish using the IANA after formal review if required.
758    
759     Changes should be requested only when there are serious omissions
760     or errors in the published specification. When review is required,
761     a change request may be denied if it renders a use of negotiated
762     capabilities that was valid under the previous definition invalid
763     under the new definition.
764    
765     The owner of a feature tag may pass responsibility for the feature
766     tag to another person or agency by informing the IANA and the
767     ietf-feature-tags list; this can be done without discussion or
768     review.
769    
770     The IESG may reassign responsibility for a feature tag. The most
771     common case of this will be to enable changes to be made to tags
772     where the author of the registration has died, moved out of contact
773     or is otherwise unable to make changes that are important to the
774     community.
775    
776     Feature tag registrations may not be deleted; feature tags which
777     are no longer believed appropriate for use can be declared OBSOLETE
778     by a change to their "intended use" field; such feature tags will
779     be clearly marked in the lists published by the IANA.
780    
781    
782     3.8 Registration template
783    
784     To: iana@isi.edu
785     Subject: Registration of feature tag XXXX
786    
787     | Instructions are preceded by `|'. Some fields are optional.
788    
789     Feature tag name:
790    
791     Feature tag summary:
792    
793     | See appendix A for the format of a feature tag summary
794    
795     Presence of the tag indicates:
796    
797     Tag value (if any) indicates:
798    
799     Predefined tag values (if any):
800    
801     Absence of the tag indicates: [optional]
802    
803     Intended typical use: [optional]
804    
805     | Supply examples of Accept-Features headers, variant
806     | descriptions, and/or variant lists. Add comments if
807     | necessary.
808    
809     Detailed description of indicated capability or preference: [optional]
810    
811     | If more than 100 lines are needed, a reference to a related
812     | standard or document is preferred.
813    
814     Related standards or documents: [optional]
815    
816     Applications or sites which will use this feature tag: [optional]
817    
818     | For applications, also specify the number of the first version
819     | which will use the tag.
820    
821     Security considerations:
822    
823     Additional information: [optional]
824    
825     Keywords: [optional]
826    
827     Related feature tags: [optional]
828    
829     Related media types: [optional]
830    
831     | For example text/html if the tag indicates the capability
832     | to handle some HTML extension.
833    
834     Related markup tags: [optional]
835    
836     | For example <table>. Note that the markup language does not
837     | need to be text/html. Add comments if necessary.
838    
839     See also: [optional]
840    
841     Person & email address to contact for further information:
842    
843     Intended usage:
844    
845     | one of COMMON, LIMITED USE or OBSOLETE
846    
847     Author/Change controller:
848    
849    
850     | Any other information that the author deems interesting may be
851     | added below.
852    
853    
854     4 Acknowledgments
855    
856     More than half of the text in Section 3 was taken from [3]. The
857     authors wish to thank Larry Masinter for contributing to early
858     discussions of feature tag registration.
859    
860    
861     5 References
862    
863     [1] Fielding et al, Hypertext Transfer Protocol -- HTTP/1.1.
864     Internet-Draft draft-ietf-http-v11-spec-06.txt, HTTP Working
865     Group, July 4, 1996
866    
867     [2] K. Holtman, A. Mutz, Transparent Content Negotiation in HTTP,
868     Internet-Draft draft-holtman-http-negotiation-03.txt, HTTP
869     Working Group, September 6, 1996
870    
871     [3] N. Freed, J. Klensin, J. Postel, Multipurpose Internet Mail
872     Extensions (MIME) Part Four: Registration Procedures
873     Internet-Draft draft-ietf-822ext-mime-reg-04.txt, Network
874     Working Group, June 1996
875    
876    
877     6 Author's address
878    
879     Koen Holtman
880     Technische Universiteit Eindhoven
881     Postbus 513
882     Kamer HG 6.57
883     5600 MB Eindhoven (The Netherlands)
884     Email: koen@win.tue.nl
885    
886     Andrew H. Mutz
887     Hewlett-Packard Company
888     1501 Page Mill Road 3U-3
889     Palo Alto CA 94304, USA
890     Fax +1 415 857 4691
891     Email: mutz@hpl.hp.com
892    
893    
894     Appendix A: Feature tag summaries
895    
896     [##The text in this appendix will probably be included in the next
897     version of [2]##]
898    
899     A feature tag summary is a compact description of a feature tag
900     which uses the following typographical format:
901    
902     <tag declaration>
903    
904     <text describing the tag>
905    
906     This format was designed to allow for the easy construction of web
907     pages listing many feature tags.
908    
909     The <tag declaration> part gives the tag name and specifies the
910     intended use of the tag. There are four possible forms:
911    
912     Form of tag declaration: Intended use of tag:
913     ============================== ===========================
914     tag_name without a value
915    
916     tag_name=value_description with zero or more values
917    
918     tag_name={value_description} with a single value
919    
920     tag_name<=value_description with a numeric range
921    
922    
923     The <text describing the tag> part should consist of one to four
924     sentences describing the tag. The text often starts with
925     `Indicates support for ....' for tags describing capabilities and
926     `Indicates a preference for ....' for tags describing preferences.
927     An example of a feature tag summary is:
928    
929     html=version
930    
931     Indicates support for the given HTML version. Predefined
932     values are 1.0, 2.0, 3.2. Example: Accept-Features: html=2.0,
933     html=3.2, *
934    
935    
936     Appendix B: IANA and RFC editor to-do list
937    
938     VERY IMPORTANT NOTE: This appendix is intended to communicate
939     various editorial and procedural tasks the IANA and the RFC
940     Editor should undertake prior to publication of this document
941     as an RFC. This appendix should NOT appear in the actual RFC
942     version of this document!
943    
944     This document refers to the feature tags mailing list
945     ietf-feature-tags@iana.org. This list does not exist at the
946     present time and needs to be created.
947    
948     The ftp://ftp.isi.edu/in-notes/iana/assignments/feature-tags/" area
949     does not exist at the present time and needs to be created.
950    
951    
952     Expires: April 30, 1997

admin@suikawiki.org
ViewVC Help
Powered by ViewVC 1.1.24