Lack of documentation

Hi,

I admit I'm here for curiosity only. I feel WM is not the tool I would like to use, but I don't want to miss something.

What I'm missing currently is a good documentation, e.g. like Google Maps API:

Look here: http://www.asp.net/webmatrix/tutorials/asp-net-web-pages-api-reference

WebGrid.GetHtml()

Renders markup to display data in an HTML table.

@grid.GetHtml()// The 'grid' variable is set when WebGrid is created.

But surprisingly grid.GetHtml() has much more capabilities, which are discovered in the tutorials.

Q: Where can I get a complete list of parameters and options for GetHtml()?

Regards

Re: Lack of documentation

At the moment, the best thing to do is download Reflector (http://www.red-gate.com/products/reflector/) and peer at the innards of Microsoft.WebPages.Helpers.dll, which you will find in the {Program Files}\Microsoft ASP.NET\ASP.NET Web Pages\v1.0\Assemblies folder. You'll see that there is actually just one WebGrid.GetHtml() method, but it can take a number of optional parameters.

Re: Lack of documentation

Thanks. Did that... However, this way is obviuosly the expert way, not the way for the targeted audience...

Don't know, why it is not possible to provide a useful documentation JIT. MS might learn from GOOG how to do that (http://code.google.com/intl/de/apis/maps/documentation/javascript/v2/reference.html)

OK, now I know, what WebMatrix is... I think I'll leave it aside...

Thanks

Re: Lack of documentation

Yes, WebMatrix is currently in Beta. For those who would like to use Visual Studio to see WebMatrix API, especially the types related to helpers, take a look at the blog post I created early this week.

Understanding WebMatrix Helpers using Visual Studio's Object Browser

Also, I posted information about WebMatrix helpers if you're interested in quick helper descriptions and syntax:

WebMatrix Helpers

Also, there are several fundamental chapters already available for WebMatrix Beta available on the asp.net site:

WebMatrix Fundamentals

Hope this helps.

-- Erik Reitan
ASP.NET User Education
This posting is provided "AS IS" with no warranties, and confers no rights.

Re: Lack of documentation

Hi Erik,

thanks, but GOOG is _always_ in Beta, that isn't an argument. Thanks for the link to your blog, but unfortunately the WebGrid isn't described. The second link was the source of my complaints, because it reveals all the nitty-gritty extra options :)

Regards

Re: Lack of documentation

neilyoung
GOOG is _always_ in Beta, that isn't an argument.

Whereas WebMatrix is destined not to be. So maybe that is an argument :o)

Re: Lack of documentation

As the previous poster notes, for the beta we did not provide complete API docs, just the "quick ref" appendix. The intent is to do that, tho, as we do for other bits of the ASP.NET framework.