#microformats 2022-09-08

2022-09-08 UTC
jacky, jeremycherfas, jacky_, ur5us, m5zs7k, [Murray], [Jamie_Tanna], [campegg], [snarfed], angelo and neceve_ joined the channel
#
capjamesg [tantek] We discussed mf2 contributions to MDN a few months ago. Were there any major topics we might want to consider documenting on MDN?
#
[tantek]4 I think we should at least outline (for microformats) plans to get various *commonly IndieWeb* *used* vocabularies their own MDN pages (extracted & expanded from the current MDN microformats page). For more IndieWeb related stuff, I'll switch to #indieweb-meta
#
capjamesg What would you like to see in those pages in terms of structure?
#
[tantek]4 That's a good question. I'd like to see h-event added as well, both as its own page and to the overview on the MDN microformats page
#
capjamesg takes notes as he wants to write more documentation for MDN :)
#
[tantek]4 capjamesg, as a comparison, see the structure of the MDN microdata page: https://developer.mozilla.org/en-US/docs/Web/HTML/microdata — I believe there are sections there that deserve an equivalent on the MDN microformats page
#
capjamesg Like commonly used vocabularies? I like that section.
#
capjamesg Then, later, that could link out to different MDN pages.
[aciccarello] joined the channel
#
[tantek]4 Correct
#
[tantek]4 and I thought the abstract table of structured data was helpful too
#
capjamesg I'd definitely like to see a h-event page. For structure, something like: definition / history, marked up example, reference of options?
#
capjamesg I'm trying to mentally image how to distinguish the h-event page so it isn't duplicative of the standard.
#
[tantek]4 definitely no need for history
#
[tantek]4 ain't no one got time for the cool story
#
[tantek]4 think about it from a purely web developer perspective who wants to spend the minimum time necessary learning what is this thing, what is it for, how can I quickly implement it on my site / pages
#
[tantek]4 for now I'd focus on adding h-event to the main MDN microformats page in the same way that h-entry is there. h-feed deserves adding there too since both of those have numerous publishers & consuming apps/services
#
capjamesg Definition, why it's useful, how to implement, reference at end for all attributes?
#
capjamesg It seems we have h-event already: https://developer.mozilla.org/en-US/docs/Web/HTML/microformats#h-event
#
[tantek]4 once the main MDN microformats page grows like that, it becomes more apparent that it's worth creating separate new pages for each of the commonly used vocabularies
#
capjamesg Of course it could be improved a lot.
#
capjamesg Which I can do without breaking it out into its own page.
#
[tantek]4 ah yes, and h-feed too. somehow missed that
#
[tantek]4 note that h-event is not listed here: https://developer.mozilla.org/en-US/docs/Web/HTML/microformats#microformats_prefixes
#
capjamesg Will fix.
#
capjamesg Is it worth adding h-review too?
#
[tantek]4 if you can find consuming apps/services
#
[tantek]4 similarly for h-recipe
#
[tantek]4 there MUST be actual useful, testable, interesting consuming apps/services to be worth documenting it on MDN for web developers
#
capjamesg Oh. Good call.
#
[tantek]4 if there isn't a very clear benefit to your typical / average web developer, it's not worth it
#
[tantek]4 we need to set a high bar
#
capjamesg Wait...
#
capjamesg I don't see any consuming applications on the indieweb wiki page for h-review?
#
capjamesg What!
ur5us and jacky joined the channel