Hello all I want to discuss an idea with you all. As Umbraco V7 aka Belle the back office is going to be written with AngularJS and mainly use rest based API calls to GET, POST, PUT and DELETE.

So with that being said I wanted to suggest a way to help us all as developers to the Umbraco platform, is that the Umbraco core team add in the nuget package ASP.NET WebAPI Help pages, that auto documents WebAPI calls.

http://www.asp.net/web-api/overview/creating-web-apis/creating-api-help-pages

http://blogs.msdn.com/b/yaohuang1/archive/2012/08/15/introducing-the-asp-net-web-api-help-page-preview.aspx

http://blogs.msdn.com/b/yaohuang1/archive/2012/09/30/asp-net-web-api-help-page-part-1-basic-help-page-customizations.aspx

http://blogs.msdn.com/b/yaohuang1/archive/2012/10/13/asp-net-web-api-help-page-part-2-providing-custom-samples-on-the-help-page.aspx

http://blogs.msdn.com/b/yaohuang1/archive/2012/12/10/asp-net-web-api-help-page-part-3-advanced-help-page-customizations.aspx

So as this is quite easy to setup and configure it seems and could even be styled to fit in with the Umbraco back office styling and even have its own custom route URL such as /Umbraco/help for example.

What do we all think of this idea, good or bad?

Cheers, Warren