RSE Wiki Archive

User Tools

Site Tools

Trace:
design:xml-tags

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision 		Previous revision
design:xml-tags [2014/01/24 10:41]
paul [Remove from v2 Vocabulary] 		design:xml-tags [2014/03/17 08:57] (current)
paul Removed most of the content from the page, and backed it up at id=design:old-xml-tags
Line 1: Line 1:
-The following are proposed changes to the xml2rfc v2 vocabulary to make v3 of the vocabulary. The new vocabulary will be used for the canonical versions of RFCs. Discussion of these proposed changes are happening on [[rfc-interest@rfc-editor.org]]. +**This page, which mostly was used to mark closed issues, is no longer active. If you have questions, please contact me at [[paul.hoffman@vpnc.org]].**
- +
-=====  Archival Considerations ===== +
- +
-All auto-generated text that appears in the other formats needs to also exist in the canonical XML file as well. That text needs its own markup. The auto-generated text includes: +
- +
-  * Section numbers +
-  * Figure numbers +
-  * Table numbers +
-  * IPR boilerplate +
- +
- +
-=====  Document Metadata ===== +
- +
-Extend the concept of language tagging to at least examples and contact information to address potential CJK font confusion. //Under discussion on rfc-interest starting 2014-01-12// +
- +
-Provide a way to indicate the intended level on the standards track while a document is still an Internet-Draft.  //Under discussion on rfc-interest starting 2014-01-12// +
- +
-Include feedback information so that generated documents can provide usable feedback links.  //Under discussion on rfc-interest starting 2014-01-12// +
- +
-Make the <date> element optional; all of its content is optional already.  //Under discussion on rfc-interest starting 2014-01-12// +
- +
-There should be a way to mark a section as something that will not appear in the published RFC. //Under discussion on rfc-interest starting 2014-01-12// +
- +
-=====  Contact Information ===== +
- +
-Add a mechanism for a ASCII fallback for non-ASCII names and addresses. Both forms should be searchable. +
- +
-Get rid of the restrictions in <postal>, and make it free text in order to better handle different styles of postal addressing throughout the world. //General agreement on this on rfc-interest.// +
- +
-=====  Figures ===== +
- +
-Clean up the set of overlapping attributes between <figure> and <artwork>. +
- +
-Remove anything that has to do with horizontal or vertical whitespace. +
- +
-Extend <figure> to support different types of artwork. +
- +
-===== Floating Figures ===== +
- +
-Suggestion that we allow figures to have text wrapped around them. //General dislike for this, or thinking that we don't need it, on rfc-interest.// +
- +
-=====  Linking ===== +
- +
-Extend <xref> so that subsection and/or anchors can be specified. +
- +
-Remove the "pageno" attribute. +
- +
-=====  Lists ===== +
- +
-Allow multiple paragraphs in a list item; eliminate the need to use <vspace>. //General approval of this idea from rfc-interest, particularly for making list items have their own element type.// +
- +
-Create a new list style for dictionaries. //General agreement on rfc-interest.// +
- +
-===== References to Lists ===== +
- +
-Items that need to be discussed. //Under discussion on rfc-interest starting 2014-01-09// +
- +
-  - Ordered List ItemShould the reference value reflect the style, and in that case what is the correct reference value to use for each of the styles. +
-  - Should the reference value be built from the chain of list elements? +
-  - Should it be possible to generate a reference that is a partial list of the chain of elements +
-  - Should the default string be something other than Paragraph XXXXX +
-There have been a number of times where I have had a style="numbers" list and then in the main text referred back to one or more steps.  By doing this using anchors rather than by hand it makes sure that the step number is correct.  +
-=====  References ===== +
- +
-Allow overriding the "anchor" attribute of an included <reference> element. //No objections to this for v3 from rfc-interest.// +
- +
-Add a way to add prose to a reference that avoids abuse of <seriesInfo>. //No objections to this for v3 from rfc-interest.// +
- +
-Allow <reference>s that identify a document set such as a multi-RFC BCP or a multi-document standard from another SDO. //Lots of discussion on how to do this for v3 on rfc-interest.// +
- +
-Deprecate or remove the <format> element. One idea was to use new elements such as @rel; another is to just point to the main RFC Info page. //Lots of discussion on this for v3 on rfc-interest.// +
- +
-===== Remove from v2 Vocabulary ===== +
- +
-In v2, there are a few elements that require their sub-elements to be in a certain order even though that order isn't really needed by the XML processor. For example, <address> requires the enclosed <postal>, <phone>, <facsimile>, <email>, and <uri> elements be in exactly that order. Given that each sub-element has its own name, the order should not be important. //A few questions about how the current processors work, but no objections to this for v3 from rfc-interest.// +
- +
-<spanx> has both a weird whitespace model ("preserve") and problematic styling.  Deprecate it in favor of elements such as <em> and <code>. //No objections to this for v3 from rfc-interest. -00// +
- +
-===== Sections Without Numbers ===== +
- +
-The <section> element could have an attribute to indicate that the section is not numbered. This is useful for top-level sections at the end of a part (such as "Contributors"), and also for low-level sections whose numbers would make the headings hard to read. Processors need to check that this attribute is used in allowed places. An alternative model would be to allow the <note> element (which is only allowed as part of <abstract> in v2) to appear in any of the <middle> and <back> parts as well; again, the processor would need to check the position of this element. //No objections to this for v3 from rfc-interest. -00// +
- +
-===== Tables ===== +
- +
-Maybe allow for xrefs to be used in the <ttcol> element.  It might also be reasonable to allow for iref and cref and eref and spanx to be used here as well. //No objections to this for v3 from rfc-interest. -00//+
design/xml-tags.1390588897.txt.gz · Last modified: 2014/01/24 10:41 by paul

Page Tools

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki