Atom Spec : http://a9.com/-/spec/opensearch/1.1

[Chris Chabot]

From:
http://www.opensocial.org/Technical-Resources/opensocial-specification----implementation-version-08/restful-api-specification

It mentions the application/atom+xml representation:
<feed xmlns="http://www.w3.org/2005/Atom" xmlos:osearch="http://a9.com/-/spec/opensearch/1.1
">

However when you'd take a look at http://a9.com/-/spec/opensearch/1.1
it returns:
HTTP/1.1 302 Moved Temporarily : http://localhost:8080/a9website/opensearch/spec/1.1/?namespace=true

Is that supposed to happen?

-- Chris

[John Panzer]

OK, so this is a typo in the spec. 

xmlos:osearch

should be

xmlns:osearch

grrr..

PROPOSAL: Fix the typo.


John Panzer (http://abstractioneer.org)

[Chris Chabot]

ps we have a small collection of typo's that could do with correcting in the spec document, plus another thread (I'm aware of only one but there might be more?) with some clarifications at http://groups.google.com/group/opensocial-and-gadgets-spec/browse_thread/thread/2d542afdaf412c04)

Might it be good to maybe update the main document and get those fixed up? :)

-- Chris

[Arne Roomann-Kurrik]

We've been fixing any obvious typos in the documentation, but adding clarification sections is a different animal that I don't want to touch without wider consensus.  Perhaps some other people could chime in about what sort of process they would like to see for such changes?

Do you have a list of typos that need fixing, Chris?

~Arne

--
OpenSocial IRC - irc://irc.freenode.net/opensocial

[Dan Peterson]

Clarifications being written up and proposed would be great.

-Dan

[Chris Chabot]

The easy to fix obvious typo's:

xmlos:search

should be 

xmlns:osearch

<author><url>uurn:guid:example.org:58UIDCSIOP233FDKK3HD44</url></
author>

should be:

<author><uri>urn:guid:example.org:58UIDCSIOP233FDKK3HD44</uri></
author>

"using the index field; this is requested by supplying a query parameter
"indexBy" (see below). "

In the document it's -above- and not below that paragraph.

There's 2 of these:

   <appdata>
        <pokes>3</poke>
        <last_poke>"2008-02-13T18:30:02Z"</last_poke>
      </appdata>

should be :

    <appdata xmlns="http://opensocial.org/2008/opensocial">
        <pokes>3</poke>
        <last_poke>2008-02-13T18:30:02Z</last_poke>
      </appdata>

POST /people/@me/@all HTTP/1.1

Host: api.example.org

Content-Type: application/json

...representation of new Person elided...

Should be:

POST /people/@me/@friends HTTP/1.1

Host: api.example.org

Content-Type: application/json

...representation of new Person elided...

-- Chris

[Arne Roomann-Kurrik]

Thanks Chris, we'll get these changes made.

~Arne

[scottk]

These are all fixed now on opensocial.org. Thanks for pointing them
out.

-Scott

> > On Mon, Jul 14, 2008 at 4:17 PM, Chris Chabot <chab...@xs4all.nl> wrote:
>
> >> ps we have a small collection of typo's that could do with correcting in
> >> the spec document, plus another thread (I'm aware of only one but there
> >> might be more?) with some clarifications at

> >>http://groups.google.com/group/opensocial-and-gadgets-spec/browse_thr...)<http://groups.google.com/group/opensocial-and-gadgets-spec/browse_thr...>

> >> Might it be good to maybe update the main document and get those fixed up?
> >> :)
>
> >> -- Chris
>
> >> On Jul 15, 2008, at 1:10 AM, John Panzer wrote:
>
> >> OK, so this is a typo in the spec.
>
> >> xmlos:osearch
>
> >> should be
>
> >> xmlns:osearch
>
> >> grrr..
>
> >> PROPOSAL: Fix the typo.
>
> >> John Panzer (http://abstractioneer.org)
>

> >> On Sat, Jul 12, 2008 at 6:06 AM, Chris Chabot <chab...@xs4all.nl> wrote:
>
> >>> From:
>
> >>>http://www.opensocial.org/Technical-Resources/opensocial-specificatio...

>
> >>> It mentions the application/atom+xml representation:
> >>> <feed xmlns="http://www.w3.org/2005/Atom" xmlos:osearch="
> >>>http://a9.com/-/spec/opensearch/1.1
> >>> ">
>

> >>> However when you'd take a look athttp://a9.com/-/spec/opensearch/1.1

[Chris Chabot]

I think while correcting the typo's these accidently got corrected the wrong way around:

On Jul 16, 2008, at 1:52 PM, Chris Chabot wrote:

<author><url>uurn:guid:example.org:58UIDCSIOP233FDKK3HD44</url></
author>

should be:

<author><uri>urn:guid:example.org:58UIDCSIOP233FDKK3HD44</uri></
author>

All the references are now to:

<author><url>urn:guid:example.org:58UIDCSIOP233FDKK3HD44</url></author>

while it should be:

[Chris Chabot]

Also the name space references are broken in the document (missing end quote):

<entry xmlns="http://www.w3.org/2005/Atom>

should be:

<entry xmlns="http://www.w3.org/2005/Atom">

else xml parsers might get very upset with you :)

-- Chris

[Chris Chabot]

yes i'm as bored of typos as you are I'm sure but this also tends to upset xml parsers:

<pokes>3</poke>

should be either

<poke>3</poke>

or

<pokes>3</pokes>

[Chris Chabot]

Lets play a game of "spot the difference"

<body_id>383777272</bodyId>

Oh and this is also probably not quite intended:

    <activity xmlns="http://ns.opensocial.org/2008/opensocial">

      <bodyId>383777272</bodyId>

    <activity>

ending with a </activity> might be boring but offers practical benefits :)

Last remark:

<content>Click <a href="http://app.example.org/invites/{msgid}">here</a> to review your invitation.</content>

the raw html (<a> ... </a>) seems to be likely to upset html parsers too ... either &lt; and &gt; or a cdata around the content could improve the results greatly...

-- Chris

[scottk]

Fixed (again). Thanks for spotting these, Chris. Please let us know if
you see any more (or if I "mis-corrected" anything).

-Scott

[Chris Chabot]

On Jul 17, 2008, at 8:41 PM, scottk wrote:

> Please let us know if you see any more

Just a small one:
<title type="html"><a href="foo">some activity</a></title>

&lt; &gt; would work better there :)

[John Panzer]

yup. (whoops)

--
John Panzer (http://abstractioneer.org)