User Tools

Site Tools


design:html-requirements

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
Next revision Both sides next revision
design:html-requirements [2014/09/15 08:25]
rsewikiadmin
design:html-requirements [2014/09/15 13:03]
rsewikiadmin
Line 97: Line 97:
 > also suspect we should be pulling out a section explicitly discussing  > also suspect we should be pulling out a section explicitly discussing 
 > these ids).  > these ids). 
 +
 +====Other open issues====
 +> What prefixes to use for autogenerated tags?
 +
 +> Should an RFC style document encourage authors to use common tags for
 +> things like "Security Considerations," "IANA Considerations," etc., to
 +> help solve for the problem of intuitive pointers to common sections in 
 +> RFCs? 
 +(so far, Design Team has had one yes, one no)
 +
 +> What reference to use (if any) for HTML5?
 +
 +> Where is the line between indicating what the XML should do within the HTML
 +> for things like ASCII art, packet diagrams, etc, and what is appropriately 
 +> just information for the XML draft?
 +
 +> Should the HTML tags in the Appendixes stay (and get cleaned up) or be removed?
 +
 +>
 +> Using classes instead of ids to aid with styling.
 +> This is a very good point. If others agree, I would propose that the current 
 +> draft be changed from "<div id='abstract'>" to "<div class='abstract'>" and 
 +> that we specify classes for all sections that seem to have special meanings.
 +
 +> It's not clear what "same logic" in "Paragraphs are wrapped in <div>s using 
 +> the same logic as sections" means. Is this intending to talk about how id 
 +> attributes get placed, or something else? 
 +
 +
 +> The document says "Additionally, anchors expressed in the source XML should 
 +> be exposed as anchors in the HTML as well." I suggested in my nits message 
 +> striking "Additionally," and "as well". But it occurs to me that the document 
 +> needs to be more specific and reflect _how_ the source XML allows anchors to 
 +> be expressed, and how those will be translated into the HTML. This falls, I 
 +> think, into being clearer about author-provided and autogenerated ids.
 +
 +> There's text that says to wrap section numbers in an 
 +> <a class='self-ref' href=...>. I suspect this should apply to other <a href> 
 +> that are generated?
 +
 +> The paragraph that begins "For other block items, such as <figure>, <t>, 
 +> and <texttable> is talking about XML, not HTML. Can it be rewritten more 
 +> specifically in terms of input and output? 
  
design/html-requirements.txt ยท Last modified: 2014/09/17 07:28 by rsewikiadmin