Jon Garfunkel

We're evaluating SharePoint 2007 now.

And I'll admit I have a bias towards clean URLs and general REST awareness. To quote Jon Udell in 2001: "The notion that URLs can represent frozen and distributable application states is tremendously powerful, and perhaps still not understood as well or exploited as effectively as it should be."

I was floating some ideas in the SharePoint/ECM blog about how REST could be used for facet-based browsing:

The answer there was that this could be supported by tweaking the Taxonomy toolkit. I suppose I can try that out, but I was hoping it could come from out of the box.

Also, the discussion thread URLs that I see out of the box are strange. While these MSDN forums threads are very clean, it appears like SharePoint puts the entire subject line in the URL! If I reuse the same subject line, SharePoint distinguishes them by adding a random 4-digit number to the end.

How was this decision made

Lastly, the wiki component is very helpful. It's really not hard to do wikis, you just allow the user to create a link before creating the document. Yet SharePoint does two things differently than MediaWiki in its encoding schemes, and neither seem like progressive ideas. First, it encodes spaces as %20 rather than an underscore. Worse, it doesn't encode any other special characters at all. So take a user unfamiliar with CamelCase conventions; they may likely create a link with all sorts of syntax in it. Yet SharePoint will whitewash it all to spaces without a warning. Then when the user creates the document, they'll end up encoding the name differently.



Re: SharePoint - General Question and Answers and Discussion MOSS, REST and Clean URL's

Lawrence Liu - MSFT

Jon, most of SharePoint's URLs are not "clean" because they were not designed as RESTful APIs. We will consider providing more RESTful APIs in future versions of SharePoint, but I cannot make any promises at this point.

<Lawrence />





Re: SharePoint - General Question and Answers and Discussion MOSS, REST and Clean URL's

Jon Garfunkel

Lawrence,

Thanks for your response.

Granted, one often designs a RESTful API (specifically, clean URL's) without even thinking about it.

SharePoint 2003 used ID's to reference forum threads (as do MSDN forums, and most every traditional bulletin board). Thus somebody asked for a specific change in 2007 to use the encoded titles within the principal URL. Who asked for that change, and why

Separately, looking at the wiki tool, it's clearly been redesigned from scratch; it's much better designed than the common HTML parts (like Notes). It's a nice touch to add check-in/check-out to wiki. But still, I might have expected you to follow the MediaWiki conventions in how wiki pages are titled/referenced. Spaces look better as underscores, and not as %20.

Jon





Re: SharePoint - General Question and Answers and Discussion MOSS, REST and Clean URL's

Jamie Thomson

Lawrence Liu - MSFT wrote:

Jon, most of SharePoint's URLs are not "clean" because they were not designed as RESTful APIs. We will consider providing more RESTful APIs in future versions of SharePoint, but I cannot make any promises at this point.

<Lawrence />

If there is a place where one can request RESTful APIs in Sharepoint then please point me to it. I fully support what Jon is saying and am rather shocked that MOSS does not support it already.

In addition to what Jon is saying I'd like to see the following:

  • http://sspoint2007-dev/Docs/wiki/Forms/ShowList.aspx Author=Garfunkel,%20Jon&output=rss
  • http://sspoint2007-dev/Docs/wiki/Forms/ShowList.aspx DocType=FYI&output=rss
  • http://sspoint2007-dev/Docs/wiki/Forms/ShowList.aspx DocType=FYI&Author=Garfunkel,%20Jon&output=rss

    or

  • http://sspoint2007-dev/Docs/wiki/Forms/ShowList.aspx Author=Garfunkel,%20Jon&output=atom
  • http://sspoint2007-dev/Docs/wiki/Forms/ShowList.aspx DocType=FYI&output=atom
  • http://sspoint2007-dev/Docs/wiki/Forms/ShowList.aspx DocType=FYI&Author=Garfunkel,%20Jon&output=atom

    -Jamie






  • Re: SharePoint - General Question and Answers and Discussion MOSS, REST and Clean URL's

    Jon Garfunkel

    :-) as we discussed on this other thread.

    It's been four months, and this thread is still the top Google hit for SharePoint Clean URL's.