Re: initial draft of "URI Template Descriptions"
Cíat Ó Gáibhtheacháin <[email protected]>
| Newsgroups | gmane.comp.web.services.rest |
|---|---|
| Message-ID | <[email protected]> |
You realise that URI templates and forms are, more-or-less, the same kind of thing, albeit with the former being more flexible in kinds of URI it can generate than the latter? Nicholas Shanks <[email protected]> wrote: > > >I think URI templating is detrimental to the web and should not receive any standards body endorsement. Can you present a use case which cannot be solved by lists of URIs and forms? > >— Nicholas. > > >On 7 Dec 2012, at 20:45, Erik Wilde <[email protected]> wrote: > > > >hello all. > >i just sumbitted an initial draft of "URI Template Descriptions" as >draft-wilde-template-desc-00. however, it seems that there currently is >a bit of delay before submissions become actually visible, so in the >meantime i'd like to announce the draft on this list, and start >gathering feedback. i'll send a brief note once the draft is available >through the official IETF channels. > >all of this is still work in progress, but i thought it would be great >to get community feedback early on. at >https://github.com/dret/I-D/tree/master/template-desc you can find the >document sources, as well as a schema (yes, it's XSD) td-00.xsd and a >simple sample description document td-paging-00.xml. since this is meant >to be for describing and documentation, td-00.xslt is a simple XSLT that >can be used to generate a simple HTML version of the description. >td-paging-00.xml links to this stylesheet, and XSLT-capable browsers >will render the HTML client-side. but you can also simply look at >td-paging-00.html for the static HTML version. > >for now, i'd be interested in feedback about the idea as a whole, as >well as about features/capabilities you'd like to see added, if you are >considering this to be something that could be useful for you. >implementation-wise, i'd like to add URI Template support to the code >(but then it needs to be XSLT 2.0 and stops working client-side), so >that it would be possible to parse the URI Template, and match variables >in it against variables in the description. > >thanks and cheers, > >dret. > >-- >erik wilde | mailto:[email protected] - tel:+1-510-2061079 | >| UC Berkeley - School of Information (ISchool) | >| http://dret.net/netdret http://twitter.com/dret | > > > ><!-- #ygrp-mkp { border: 1px solid #d8d8d8; font-family: Arial; margin: 10px 0; padding: 0 10px; } #ygrp-mkp hr { border: 1px solid #d8d8d8; } #ygrp-mkp #hd { color: #628c2a; font-size: 85%; font-weight: 700; line-height: 122%; margin: 10px 0; } #ygrp-mkp #ads { margin-bottom: 10px; } #ygrp-mkp .ad { padding: 0 0; } #ygrp-mkp .ad p { margin: 0; } #ygrp-mkp .ad a { color: #0000ff; text-decoration: none; } #ygrp-sponsor #ygrp-lc { font-family: Arial; } #ygrp-sponsor #ygrp-lc #hd { margin: 10px 0px; font-weight: 700; font-size: 78%; line-height: 122%; } #ygrp-sponsor #ygrp-lc .ad { margin-bottom: 10px; padding: 0 0; } #actions { font-family: Verdana; font-size: 11px; padding: 10px 0; } #activity { background-color: #e0ecee; float: left; font-family: Verdana; font-size: 10px; padding: 10px; } #activity span { font-weight: 700; } #activity span:first-child { text-transform: uppercase; } #activity span a { color: #5085b6; text-decoration: none; } #activity span span { color: #ff7900; } #activity span .underline { text-decoration: underline; } .attach { clear: both; display: table; font-family: Arial; font-size: 12px; padding: 10px 0; width: 400px; } .attach div a { text-decoration: none; } .attach img { border: none; padding-right: 5px; } .attach label { display: block; margin-bottom: 5px; } .attach label a { text-decoration: none; } blockquote { margin: 0 0 0 4px; } .bold { font-family: Arial; font-size: 13px; font-weight: 700; } .bold a { text-decoration: none; } dd.last p a { font-family: Verdana; font-weight: 700; } dd.last p span { margin-right: 10px; font-family: Verdana; font-weight: 700; } dd.last p span.yshortcuts { margin-right: 0; } div.attach-table div div a { text-decoration: none; } div.attach-table { width: 400px; } div.file-title a, div.file-title a:active, div.file-title a:hover, div.file-title a:visited { text-decoration: none; } div.photo-title a, div.photo-title a:active, div.photo-title a:hover, div.photo-title a:visited { text-decoration: none; } div#ygrp-mlmsg #ygrp-msg p a span.yshortcuts { font-family: Verdana; font-size: 10px; font-weight: normal; } .green { color: #628c2a; } .MsoNormal { margin: 0 0 0 0; } o { font-size: 0; } #photos div { float: left; width: 72px; } #photos div div { border: 1px solid #666666; height: 62px; overflow: hidden; width: 62px; } #photos div label { color: #666666; font-size: 10px; overflow: hidden; text-align: center; white-space: nowrap; width: 64px; } #reco-category { font-size: 77%; } #reco-desc { font-size: 77%; } .replbq { margin: 4px; } #ygrp-actbar div a:first-child { /* border-right: 0px solid #000;*/ margin-right: 2px; padding-right: 5px; } #ygrp-mlmsg { font-size: 13px; font-family: Arial, helvetica,clean, sans-serif; *font-size: small; *font: x-small; } #ygrp-mlmsg table { font-size: inherit; font: 100%; } #ygrp-mlmsg select, input, textarea { font: 99% Arial, Helvetica, clean, sans-serif; } #ygrp-mlmsg pre, code { font:115% monospace; *font-size:100%; } #ygrp-mlmsg * { line-height: 1.22em; } #ygrp-mlmsg #logo { padding-bottom: 10px; } #ygrp-msg p a { font-family: Verdana; } #ygrp-msg p#attach-count span { color: #1E66AE; font-weight: 700; } #ygrp-reco #reco-head { color: #ff7900; font-weight: 700; } #ygrp-reco { margin-bottom: 20px; padding: 0px; } #ygrp-sponsor #ov li a { font-size: 130%; text-decoration: none; } #ygrp-sponsor #ov li { font-size: 77%; list-style-type: square; padding: 6px 0; } #ygrp-sponsor #ov ul { margin: 0; padding: 0 0 0 8px; } #ygrp-text { font-family: Georgia; } #ygrp-text p { margin: 0 0 1em 0; } #ygrp-text tt { font-size: 120%; } #ygrp-vital ul li:last-child { border-right: none !important; } -->