I've not found that schema.org provides clear guidance over what markup to use, and when. Nor a clear indication of what the value is to sites that do implement it.<p>Take Hacker News as an example... shared links with comments.<p>Is the link itself of type WebPage? <a href="https://schema.org/WebPage" rel="nofollow">https://schema.org/WebPage</a> I would've said yes, except that the bit at the top states that all pages are implicitly WebPages and thus implicitly self-describing rather than describing a link elsewhere.<p>Unless the article/link is a WebPage.significantLink ? But that seems not significant enough for what is essentially the context for the entire page.<p>Maybe we're linking to an <a href="https://schema.org/Article" rel="nofollow">https://schema.org/Article</a> ? So we can mark the link as that. Except you and I know that not all things linked are articles, it feels like a poor fit, especially as the Article type agains describes the thing itself and not the link to it.<p>Alright, let's forget describing content elsewhere and focus on content here on this site... comments.<p>Should I use <a href="https://schema.org/UserComments" rel="nofollow">https://schema.org/UserComments</a> ? Looks like the right thing, except that this is a comment relating to (a child of) an event, which isn't a good fit.<p>But we do have a <a href="https://schema.org/Comment" rel="nofollow">https://schema.org/Comment</a> which looks like a great match, it even has an upvote and downvote count.<p>So we have a good match for comments, but not for the links... unless the news articles/posts are in fact just comments themselves? Afterall, they have an upvote and downvote, a comment body and we could always use the `url` of `Thing` for the link.<p>But in the end I'd probably mark the list of stories as simply a <a href="https://schema.org/CreativeWork" rel="nofollow">https://schema.org/CreativeWork</a> as at least that has a `discussionUrl`.<p>That works reasonably well (and I know schema.org well enough to do it swiftly), but I've given tasks like this to other devs and authors and seen wildly different results for similar things.<p>The question I'd ask, why? Why bother? It seems like a lot of work for inconsistent quality of answer, for what benefit to the sites that go to the effort?<p>With little guidance and examples for really common scenarios (blog, forum, business word press site, ecommerce shop, calendar), time and effort is poured in without any understanding of the value to be derived from that investment. It may have potential but if a client is spending money today, what value is there?