19627Fwd: [rest-discuss] Updated UBER spec doc
- Mar 10 3:10 PM*** Forwarding this to the UBER Hypermedia List ***Yeah - I totally see your point. Can you join me on the UBER list to help sort this out?---------- Forwarded message ----------
From: Will Hartung <willh@...>
Date: Mon, Mar 10, 2014 at 5:52 PM
Subject: Re: [rest-discuss] Updated UBER spec doc
To: mike amundsen <mamund@...>
Cc: rest-discuss <firstname.lastname@example.org><u:uber xmlns:u="urn:uberisuber"> <u:data>...</u:data> </u:uber><uber xmlns="urn:uberisuber"> <data> ... </data> </uber>The beauty of XML is that you can mix and mash it up, and you can't (easily) do that without a namespace.I know, I know, I like to just bang my drum and hear myself...uh..type, or something...however.Mike, please, now, if you're going to specify something for XML, give it an official namespace identifier, and REQUIRE/MUST it.
<ü:uber xmlns:ü="urn:uberisuber"> <ü:data>...</ü:data> </ü:uber>(that would be annoying, but it's amusing in context...anyway...just an abbreviation, could be anything)Lots of folks don't namespace their data, and when used internally and privately, that's fine.But as soon as you start sharing it, or using it with other XML techs (XML Sig, SOAP, SAML, etc.) things can get messy, especially for an overarching framework like you're proposing. The framework shouldn't interfere with the data.By getting this settled up front, you won't have to worry about legacy implementations (notably XSL) that rely upon your data not having a namespace breaking if/when you change it to add one. This is why you REQUIRE it, XML code is different if the elements are namespaced or not, un-namespaced and namespaced XML files aren't "the same".So, anyway, my 2 cents. I'll crawl back in to my hole.Regards,
Will HartungCONFIDENTIALITY NOTICE: The information contained in this electronic transmission may be confidential. If you are not an intended recipient, be aware that any disclosure, copying, distribution or use of the information contained in this transmission is prohibited and may be unlawful. If you have received this transmission in error, please notify us by email reply and then erase it from your computer system.
On Sat, Mar 8, 2014 at 1:40 PM, mike amundsen <mamund@...> wrote:I updated the spec docs for UBER ("Uniform Basis for Exchanging Representations") and posted the changes in a branch on github: https://rawgithub.com/mamund/media-types/spec-fixes/uber-hypermedia.htmlThis covers most of the suggestions I've had to date on cleaning up the spec and making the JSON variant more canonical.diff details can be found here: https://github.com/mamund/media-types/compare/master...spec-fixesThanks for the contributions and looking forward to the feedback.
- << Previous post in topic Next post in topic >>