Clean up <code> in XML docs #20893
Clean up <code> in XML docs #20893
Conversation
| /// context.Blogs | ||
| /// .Include(blog => blog.Posts).ThenInclude(post => post.Tags).ThenInclude(tag => tag.TagInfo) | ||
| /// .Include(blog => blog.Contributors); | ||
| /// context.Blogs |
There was a problem hiding this comment.
Not sure about the "right" way to do leading whitespace, but I do know that the current docs look bad.
Maybe @smitpatel knows if we can see a preview for this PR somehow?
There was a problem hiding this comment.
It is a very long way to generate a preview and probably not possible.
There was a problem hiding this comment.
Also write context.Blogs on same line as code and new lines offset by 3 spaces from // 🤔
There was a problem hiding this comment.
The docs for EntityFrameworkServiceCollectionExtensions seem to suggest it's possible to put it not on the same line code, but I got pretty confused by the indentation :/ Should we merge this and see what happens, possibly fix again later? Or are you sure that 3 spaces (!!) is the way to go?
There was a problem hiding this comment.
I calculated white space count in the source file, generated docs file and parsed website content. If we really care, I can get new APIs published for preview version.
There was a problem hiding this comment.
I'm going to go ahead and merge, but keep this issue to make sure the output is reasonable - let's revisit if otherwise.
Closes #20849