umbraco / UmbracoDocs

The official Umbraco Documentation
https://docs.umbraco.com
MIT License
269 stars 780 forks source link

Blogpost about Block grid assumes ModelsBuilder #5544

Closed berendvervelde closed 1 year ago

berendvervelde commented 1 year ago

What type of issue is it?

Wrong documentation

What article/section is this about?

https://umbraco.com/blog/deep-dive-block-grid-editor-part-1/

Describe the issue

In 'Rendering Block Grid Content' the code '@await Html.GetBlockGridHtmlAsync(Model.MyGrid)' will only work if you are using the ModelsBuilder but the post does not specify this. Note that the tutorial https://docs.umbraco.com/umbraco-cms/fundamentals/backoffice/property-editors/built-in-umbraco-property-editors/block-editor/block-grid-editor does show the ModelsBuilder and non-ModelsBuilder code, but the blog post shows up higher in the Google results.

alina-tincas commented 1 year ago

Hi @berendvervelde 👋

Thank you for opening this issue, however, the blog post is 1 year old so in this case, we cannot do anything about it. The blog posts are used to make know that we have some new features (in this case block grid and how to get started from scratch). Then if there are new features or content after the blog post, then the documentation is updated but not the blog posts.

The documentation is always updated with new content and features and we always recommended to check the documentation instead of the blog posts (especially if the blog posts are few months old).

It is also mentioned in this blog post: "If you haven’t tried it in Umbraco 11 and want to test out the new Property Editor we just published a Deep Dive blog post that takes you through all the basics. You can also dig into the extensive documentation for the Block Grid Editor**"

I have also tried to search in google "block grid umbraco" and the docs show first before the blog: image

I hope this makes sense, otherwise please let me know! 😊