indieweb / indieweb/authorship
Clarify step 7 "has 1+ h-card"
- Dominant language
- No language data
- Stars
- 5
- Forks
- 1
- PR merge metrics
- No merged PRs in 30d
Description
(originally posted 2017-02-24 on the wiki)
In step 7, "if author-page has 1+ h-card...", can you clarify the meaning of "has"? In my implementation, I was checking for the presence of this h-card by iterating through all top-level "items" on the page and checking those. However, I believe I found an example where this fails. When the home page h-card is actually the "author" property of the top-level h-feed, my consuming code doesn't find this h-card. Is this sentence intended to match this case? If so, clarification on what it means to say a page "has" an h-card would be helpful. Parsing the HTML for h-card will easily find this h-card, but once you're working with the mf2 parsed result, it is buried a little deeper in the data structure.
Contributor guide
No contributing guide indexed for this repository
Research direction
Start with step 7 in the wiki and review how the parsed result represents an h-card used as the author property of a top-level h-feed. Clarify what “has 1+ h-card” means in that case, including whether nested h-cards count. Done means the wording unambiguously guides consumers of the mf2 parsed result.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100