RE: Updated UBER spec doc
"Rushforth, Peter" <[email protected]> Tue, 11 Mar 2014 16:37:00 +0000
| Newsgroups | gmane.comp.web.services.rest |
|---|---|
| Message-ID | <1CD55F04538DEA4F85F3ADF7745464AF24B8BA0A@S-BSC-MBX1.nrn.nrcan.gc.ca> |
---RvsNXwAe5YF7FQWSc7T2lwX5BMyJvp1Tj4QDbP
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: base64
SGksDQoNCj4gLS0tLS1PcmlnaW5hbCBNZXNzYWdlLS0tLS0NCj4gRnJvbTogRXJpayBXaWxk
ZSBbbWFpbHRvOmRyZXRAYmVya2VsZXkuZWR1XQ0KPiBTZW50OiBNYXJjaCAxMSwgMjAxNCAw
OToyMw0KPiBUbzogUnVzaGZvcnRoLCBQZXRlcjsgV2lsbCBIYXJ0dW5nOyBtaWtlIGFtdW5k
c2VuOyB1YmVyLQ0KPiBoeXBlcm1lZGlhQGdvb2dsZWdyb3Vwcy5jb20NCj4gQ2M6IHJlc3Qt
ZGlzY3Vzcw0KPiBTdWJqZWN0OiBSZTogW3Jlc3QtZGlzY3Vzc10gVXBkYXRlZCBVQkVSIHNw
ZWMgZG9jDQo+IA0KPiBoZWxsbyBwZXRlci4NCj4gDQo+IHRoYW5rcyBmb3IgdGhlIGZlZWRi
YWNrLg0KPiANCj4gT24gMjAxNC0wMy0xMSwgMTQ6MDkgLCBSdXNoZm9ydGgsIFBldGVyIHdy
b3RlOg0KPiA+IEknbSBub3QgY29udmluY2VkIHRoYXQgdXNpbmcgbmFtZXNwYWNlcyByZWFs
bHkgZ2V0cyB5b3UgYW55dGhpbmcgaGVyZS4NCj4gPiBZb3UncmUgZGV2ZWxvcGluZyBhbiBp
bnRlcm5ldCBtZWRpYSB0eXBlLCBzbyB5b3UgYXJlIGZyZWUgdG8gc3BlY2lmeSBob3cNCj4g
PiBpdCBtYXkgL21heSBub3QgYmUgZXh0ZW5kZWQuICBNaWNyb1hNTCBtaWdodCBpbiBmYWN0
IGJlIGFsbCB0aGF0IHlvdQ0KPiA+IG5lZWQuICBXaHkgY29tcGxpY2F0ZSBtYXR0ZXJzIGZv
ciB1bmtub3duIC8gdW5zcGVjaWZpZWQgcmVxdWlyZW1lbnRzPw0KPiBLSVNTDQo+IA0KPiB0
aGlzIGlzIGEgcGVybWEtZGlzY3Vzc2lvbiB3aGVyZSBpdCdzIHVubGlrZWx5IHRoYXQgdGhl
cmUncyBhIHNpbmdsZQ0KPiBhbnN3ZXIgdGhhdCBldmVyeWJvZHkgY2FuIGFncmVlIG9uLiBt
eSBhcmd1bWVudCB1c3VhbGx5IGlzIHRoYXQgZm9yIGFuDQo+IGludGVybmV0IG1lZGlhIHR5
cGUsIGV4dGVuc2liaWxpdHkgYW5kIGNvbXBvc2FiaWxpdHkgaXMgbm90IGFuIHVua25vd24N
Cj4gb3IgdW5zcGVjaWZpZWQgcmVxdWlyZW1lbnQsIGJ1dCBzb21ldGhpbmcgdGhhdCBzaG91
bGQgYmUgZGVzaWduZWQNCj4gcHJvcGVybHkgcmlnaHQgZnJvbSB0aGUgc3RhcnQuIFhNTCBt
YWtlcyB0aGF0IHJlbGF0aXZlbHkgZWFzeS4gDQoNCk5hbWVzcGFjZXMgd2VyZSBkZXNpZ25l
ZCB0byBhZGRyZXNzIG9uZSByZWFsIHRlY2huaWNhbCByZXF1aXJlbWVudDogdG8gcHJldmVu
dCBuYW1lIGNsYXNoZXMuDQoNClRoaXMgcmVxdWlyZW1lbnQgY291bGQgYmUgYWRkcmVzc2Vk
IGluIHRoZSBjdXJyZW50IGNhc2UgYnkgYSBzdWl0YWJsZSBzY2hlbWEgLyBwcm9jZXNzaW5n
IGRlc2NyaXB0aW9uIGluIHRoZSANCnJlZ2lzdHJhdGlvbi4gIFdoeSB0aHJvdyBpbiBhbGwg
dGhlIFhNTCBsZWdhY3kgc3R1ZmYgd2hlbiB5b3UncmUgc3RhcnRpbmcgZnJlc2guICBJZiBv
bmUgZXZlciB3b3VsZCBsaWtlIHRvIHNlZQ0KYnJvd3NlciBzdXBwb3J0IGZvciBhIG1lZGlh
IHR5cGUgYmFzZWQgb24gVWJlciwgKG90aGVyIHRoYW4gaXRzIGpzb24gdmFyaWV0eSksIGl0
IHdvdWxkDQpiZSBzbWFydCB0byBsZWF2ZSBvdXQgbmFtZXNwYWNlcywgcmF0aGVyIHRoYW4g
Zm9yY2UgYWxsIHN1YnNlcXVlbnQgZGVzaWduZXJzIHRvIGFkb3B0IHRoZW0gKG9uY2UgdGhl
eSdyZSBpbg0KdGhleSBzdGF5IGluKS4gIElmIHNvbWVib2R5IG5lZWRzIHRvIHVzZSBuYW1l
c3BhY2VzIGluIHRoZWlyIGV4dGVuc2lvbnMsIEkgZ3Vlc3MgaXQgd291bGQNCmJlIG9rIHRv
IGxldCB0aGVtLg0KDQpUbyB0YWtlIGFuIGV4YW1wbGUsIEF0b20gYW5kIEF0b21QdWIuICBB
dG9tIHNheXMgdGhhdCBmb3JlaWduIG1hcmt1cCBtdXN0IGJlIGlnbm9yZWQuIA0KRm9yZWln
biBtYXJrdXAgaW4gdGhlIEF0b20gbmFtZXNwYWNlIGlzIHJlc2VydmVkIGZvciBmdXR1cmUg
QXRvbSB2b2NhYnVsYXJpZXMuIA0KQWxvbmcgY2FtZSBBdG9tUHViLiAgV2hhdCBkaWQgdGhl
eSBkbz8gIFRoZXkgYWRkZWQgYSBuZXcgbmFtZXNwYWNlLiAgV2hhdCB3aWxsIGhhcHBlbg0K
aWYgdGhlcmUgaXMgYW5vdGhlciB1cGRhdGU/ICBNb3JlIG5hbWVzcGFjZXMsIEkgc3VzcGVj
dC4gIA0KDQpUaGUgQXRvbVB1YiBleHRlbnNpb24gdG8gdGhlIHZvY2FidWxhcnkgY291bGQg
aGF2ZSBiZWVuIGRvbmUgd2l0aCBubyBuZXcgbmFtZXNwYWNlIGFuZCBkZXNjcmliZWQNCmJ5
IHRoZSBtZWRpYSB0eXBlIHJlZ2lzdHJhdGlvbiAocykuICANCg0KDQo+IG5hbWVzcGFjZXMg
YXJlIGEgdG91Y2h5IHRvcGljLCBzbyB3aGVuIHlvdSB1c2UgdGhlbSwgeW91J3JlIGxpa2Vs
eSB0bw0KPiBnZXQgc29tZSBwdXNoYmFjay4gaSdkIHNheSBsaXZlIHdpdGggdGhhdCwgYnV0
IG90aGVycyB3aWxsIGRlZmluaXRlbHkNCj4gZmVlbCBkaWZmZXJlbnRseS4NCg0KVGhpcyBp
cyB0aGF0IHB1c2hiYWNrIDstKQ0KDQo+IA0KPiBidXQ6IGV2ZW4gaWYgeW91IGdvIGZvciBu
YW1lc3BhY2VsZXNzbmVzcywgYSBwcm9jZXNzaW5nIG1vZGVsIGlzDQo+IHJlcXVpcmVkLiB3
aGF0IHRvIGRvIHdpdGggdW5rbm93biBlbGVtZW50cy9hdHRyaWJ1dGVzIG5lZWRzIHRvIGJl
DQo+IHNwZWNpZmllZC4gdGhlIHNlY3Rpb24gb24gZXh0ZW5zaWJpbGl0eSBpcyBhIGdvb2Qg
c3RhcnQsIGJ1dCBwcm9iYWJseQ0KPiBzaG91bGQgYmUgYSBiaXQgbW9yZSB0aG9yb3VnaCAo
ZS5nLiwgd2hhdCB0byBkbyB3aGVuIHRvIGZpbmQgYSBzdGFuZGFyZA0KPiB1YmVyIGVsZW1l
bnQgZW1iZWRkZWQgaW4gYW4gZXh0ZW5zaW9uKS4NCg0KKzENCg0KSSBndWVzcyB0aGlzIHRo
cmVhZCBpcyBzbGlnaHRseSBvZmYgdG9waWMuICBTb3JyeSBhYm91dCB0aGF0LiAgSSB3aWxs
IHRha2UgaXQgdG8gdGhlIFViZXIgbGlzdC4NCg0KQ2hlZXJzLA0KUGV0ZXINCg==
---RvsNXwAe5YF7FQWSc7T2lwX5BMyJvp1Tj4QDbP
Content-Type: text/html; charset=UTF-8
Content-Transfer-Encoding: 7bit
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
</head>
<body style="background-color: #fff;">
<span style="display:none"> </span>
<!--~-|**|PrettyHtmlStartT|**|-~-->
<div id="ygrp-mlmsg" style="position:relative;">
<div id="ygrp-msg" style="z-index: 1;">
<!--~-|**|PrettyHtmlEndT|**|-~-->
<div id="ygrp-text" >
<p>Hi,
<br>
<br>
> -----Original Message-----
<br>
> From: Erik Wilde [mailto:[email protected]]
<br>
> Sent: March 11, 2014 09:23
<br>
> To: Rushforth, Peter; Will Hartung; mike amundsen; uber-
<br>
> [email protected]
<br>
> Cc: rest-discuss
<br>
> Subject: Re: [rest-discuss] Updated UBER spec doc
<br>
>
<br>
> hello peter.
<br>
>
<br>
> thanks for the feedback.
<br>
>
<br>
> On 2014-03-11, 14:09 , Rushforth, Peter wrote:
<br>
> > I'm not convinced that using namespaces really gets you anything here.
<br>
> > You're developing an internet media type, so you are free to specify how
<br>
> > it may /may not be extended. MicroXML might in fact be all that you
<br>
> > need. Why complicate matters for unknown / unspecified requirements?
<br>
> KISS
<br>
>
<br>
> this is a perma-discussion where it's unlikely that there's a single
<br>
> answer that everybody can agree on. my argument usually is that for an
<br>
> internet media type, extensibility and composability is not an unknown
<br>
> or unspecified requirement, but something that should be designed
<br>
> properly right from the start. XML makes that relatively easy.
<br>
<br>
Namespaces were designed to address one real technical requirement: to prevent name clashes.
<br>
<br>
This requirement could be addressed in the current case by a suitable schema / processing description in the
<br>
registration. Why throw in all the XML legacy stuff when you're starting fresh. If one ever would like to see
<br>
browser support for a media type based on Uber, (other than its json variety), it would
<br>
be smart to leave out namespaces, rather than force all subsequent designers to adopt them (once they're in
<br>
they stay in). If somebody needs to use namespaces in their extensions, I guess it would
<br>
be ok to let them.
<br>
<br>
To take an example, Atom and AtomPub. Atom says that foreign markup must be ignored.
<br>
Foreign markup in the Atom namespace is reserved for future Atom vocabularies.
<br>
Along came AtomPub. What did they do? They added a new namespace. What will happen
<br>
if there is another update? More namespaces, I suspect.
<br>
<br>
The AtomPub extension to the vocabulary could have been done with no new namespace and described
<br>
by the media type registration (s).
<br>
<br>
<br>
> namespaces are a touchy topic, so when you use them, you're likely to
<br>
> get some pushback. i'd say live with that, but others will definitely
<br>
> feel differently.
<br>
<br>
This is that pushback ;-)
<br>
<br>
>
<br>
> but: even if you go for namespacelessness, a processing model is
<br>
> required. what to do with unknown elements/attributes needs to be
<br>
> specified. the section on extensibility is a good start, but probably
<br>
> should be a bit more thorough (e.g., what to do when to find a standard
<br>
> uber element embedded in an extension).
<br>
<br>
+1
<br>
<br>
I guess this thread is slightly off topic. Sorry about that. I will take it to the Uber list.
<br>
<br>
Cheers,
<br>
Peter
<br>
</p>
</div>
<!--~-|**|PrettyHtmlStart|**|-~-->
<div style="color: #fff; height: 0;">__._,_.___</div>
<div style="clear:both"> </div>
<table cellspacing=4px style="margin-top: 20px; margin-bottom: 10px;">
<tbody>
<tr>
<td style="font-size: 12px; font-family: arial; font-weight: bold; padding: 7px 5px 5px; color: #FFF; background-color: #F2F2F2; border: 1px solid #EAEAEA " >
<a style="text-decoration: none; color: #2D50FD" href="https://groups.yahoo.com/group/rest-discuss/post;_ylc=X3oDMTJxMjMyM284BF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BG1zZ0lkAzE5NjMyBHNlYwNmdHIEc2xrA3JwbHkEc3RpbWUDMTM5NDU1NTgyMg--?act=reply&messageNum=19632">Reply via web post</a>
</td>
<td style="font-size: 12px; font-family: arial; padding: 7px 5px 5px; color: #FFF; background-color: #F2F2F2; border: 1px solid #EAEAEA; " >
<a href="mailto:[email protected]?subject=RE%3A%20%5Brest-discuss%5D%20Updated%20UBER%20spec%20doc" style="text-decoration: none; color: #2D50FD;">
Reply to sender </a>
</td>
<td style="font-size: 12px; font-family: arial; padding: 7px 5px 5px; color: #FFF; background-color: #F2F2F2; border: 1px solid #EAEAEA; ">
<a href="mailto:[email protected]?subject=RE%3A%20%5Brest-discuss%5D%20Updated%20UBER%20spec%20doc" style="text-decoration: none; color: #2D50FD">
Reply to group </a>
</td>
<td style="font-size: 12px; font-family: arial; padding: 7px 5px 5px; color: #FFF; background-color: #F2F2F2; border: 1px solid #EAEAEA; " >
<a href="https://groups.yahoo.com/group/rest-discuss/post;_ylc=X3oDMTJlZjNicjczBF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BHNlYwNmdHIEc2xrA250cGMEc3RpbWUDMTM5NDU1NTgyMg--" style="text-decoration: none; color: #2D50FD">Start a New Topic</a>
</td>
<td style="font-size: 12px; font-family: arial; padding: 7px 5px 5px; color: #2D50FD; background-color: #F2F2F2; border: 1px solid #EAEAEA; " >
<a href="https://groups.yahoo.com/group/rest-discuss/message/19624;_ylc=X3oDMTM2OWFnZ3YwBF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BG1zZ0lkAzE5NjMyBHNlYwNmdHIEc2xrA3Z0cGMEc3RpbWUDMTM5NDU1NTgyMgR0cGNJZAMxOTYyNA--" style="text-decoration: none; color: #2D50FD;">Messages in this topic</a>
(7)
</td>
</tr>
</tbody>
</table>
<!------- Start Nav Bar ------>
<!-- |**|begin egp html banner|**| -->
<div id="ygrp-vital" style="background-color: #f2f2f2; font-family: Verdana; font-size: 10px; margin-bottom: 10px; padding: 10px;">
<span id="vithd" style="font-weight: bold; color: #333; text-transform: uppercase; "><a href="https://groups.yahoo.com/group/rest-discuss;_ylc=X3oDMTJlbzRhamo2BF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BHNlYwN2dGwEc2xrA3ZnaHAEc3RpbWUDMTM5NDU1NTgyMg--" style="text-decoration: none;">Visit Your Group</a></span>
<ul style="list-style-type: none; margin: 0; padding: 0; display: inline;">
<li style="border-right: 1px solid #000; font-weight: 700; display: inline; padding: 0 5px; margin-left: 0;">
<span class="cat"><a href="https://groups.yahoo.com/group/rest-discuss/members;_ylc=X3oDMTJmbnFrczl1BF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BHNlYwN2dGwEc2xrA3ZtYnJzBHN0aW1lAzEzOTQ1NTU4MjI-?o=6" style="text-decoration: none;">New Members</a></span>
<span class="ct" style="color: #ff7900;">3</span>
</li>
</ul>
</div>
<div id="ft" style="font-family: Arial; font-size: 11px; margin-top: 5px; padding: 0 2px 0 0; clear: both;">
<a href="https://groups.yahoo.com/;_ylc=X3oDMTJkMGM5M2luBF9TAzk3MzU5NzE0BGdycElkAzQzMTkyNTUEZ3Jwc3BJZAMxNzA1NzAxMDE0BHNlYwNmdHIEc2xrA2dmcARzdGltZQMxMzk0NTU1ODIy" style="float: left;"><img src="http://l.yimg.com/ru/static/images/yg/img/email/new_logo/logo-groups-137x15.png" height="15" width="137" alt="Yahoo! Groups" style="border: 0;"/></a>
<div style="color: #747575; float: right;"> • <a href="https://info.yahoo.com/privacy/us/yahoo/groups/details.html" style="text-decoration: none;">Privacy</a> • <a href="mailto:[email protected]?subject=Unsubscribe" style="text-decoration: none;">Unsubscribe</a> • <a href="https://info.yahoo.com/legal/us/yahoo/utos/terms/" style="text-decoration: none;">Terms of Use</a> </div>
</div>
<!-- |**|end egp html banner|**| -->
</div> <!-- ygrp-msg -->
<!-- Sponsor -->
<!-- |**|begin egp html banner|**| -->
<div id="ygrp-sponsor" style="width:160px; float:right; clear:none; margin:0 0 25px 0; background: #fff;">
<!-- Start Recommendations -->
<div id="ygrp-reco">
</div>
<!-- End Recommendations -->
</div> <!-- |**|end egp html banner|**| -->
<div style="clear:both; color: #FFF; font-size:1px;">.</div>
</div>
<img src="http://geo.yahoo.com/serv?s=97359714/grpId=4319255/grpspId=1705701014/msgId=19632/stime=1394555822" width="1" height="1"> <br>
<div style="color: #fff; height: 0;">__,_._,___</div>
<!--~-|**|PrettyHtmlEnd|**|-~-->
</body>
<!--~-|**|PrettyHtmlStart|**|-~-->
<head>
<style type="text/css">
<!--
#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;
}
-->
</style>
</head>
<!--~-|**|PrettyHtmlEnd|**|-~-->
</html>
<!-- end group email -->
---RvsNXwAe5YF7FQWSc7T2lwX5BMyJvp1Tj4QDbP--