indieweb / indieweb/authorship

Clarify step 7 "has 1+ h-card"

Open
#2 0 comments 1 reaction 0 assignees View on GitHub
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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.