#microformats 2022-02-11

2022-02-11 UTC
#
barnaby
yeah if you’re writing markup based on anticipated use cases (rather than just mark up everything which you can, which is also a valid approach) then just having mf1 vcards doesn’t really get you anything afaik
jacky joined the channel
#
[KevinMarks]
well, it will be parsed by google/schema but it won't necessarily show up anywhere
Seirdy, ur5us, darkkirb, jacky and gRegor joined the channel
#
Seirdy
how do you guys mark up links to website source code?
#
Seirdy
like a link to a software forge (e.g. Git{Hub,tea,Lab}) containing markdown files and html templates
#
Seirdy
I see that the microformats wiki has some brainstorming, and suggests rel="source" or rel="code". schema.org defines a SoftwareSourceCode itemtype, but idk if that fits.
#
[tw2113_Slack_]
can't say i do anything with this topic
#
[snarfed]
Seirdy the usual question is, what do you want other tools/applications to do with those links? we don't necessarily mark things up unless we have consuming use cases in mind
ur5us joined the channel
#
jacky
^ like [snarfed] mentioned, the consuming case can help with the goal
#
jacky
like if a visitor can click it to open it up in GitHub Desktop and make a change, that'd be interesting
#
jacky
or like if a reader was able to use that to suggest changes to a template (though that'd be something very interesting to see in the wild)
#
Seirdy
[snarfed], jacky: i'd imagine that tools that tell you the tools behind a page could leverage it. right now we have stuff like "generator" meta tags and the ability to check a server's IP range to see who hosts it; this could be part of a set of additions to mark up a page with the tools behind it.
#
Seirdy
so a page could have a "generator", "source", "sourceLicense" (as opposed to a license for the page content), "language" (vanilla html/js, vue, elm, typescript, etc), "platform" (writefreely, plume, etc), etc.
#
Seirdy
in fact, there could be a "forge" schema that specifies links like "repo", "issuetracker", "discussions" (discuss mailing list, forum built into the forge), "contributions" (devel mailing list or PR tracker), etc.
#
jacky
tbh I'd prob put that in the AS2 for my site for each page (if it's referencable - most pages are from templates and I can link to what file at what version)
#
jacky
but I'd be curious to see what kind of markup you'd come up for that!
#
Seirdy
one more question: I know that we can specify a date published, date updated, copyright date, etc. which make sense for a creative work. but how about a "date deployed"?
#
Seirdy
like if you make a change to your website's HTML templates and redeploy it but don't change any articles, so the publication/updated dates should be the same. but I have a "site last deployed on..." footer that's populated with the current timestamp in the CI job.
#
jacky
I think that one would be a bit tricky - like what exactly (from the IndieWeb lens) would be using that info?
#
jacky
like you can def publish it
#
Seirdy
an example scenario for both questions (source code and deploy-date): https://seirdy.one/
#
jacky
but if it becomes work to keep publishing it then it'd be counterintuitive
#
Seirdy
jacky: it shows that the whole static site was rebuilt/updated but not that a particular article was.
#
Seirdy
in the future it could show the git commit
#
aaronpk
Again this is all theoretical until someone else is actually consuming this data
#
aaronpk
Show whatever you want on the page for humans to read, but unless there is actually some other software out there that's going to do something useful with the data there isn't really a point in adding markup to tell computers about it
ben_thatmustbeme, [fluffy]1, gire21, [jeremycherfas]1, [manton]1, darkkirb, gRegor and [pfefferle] joined the channel
#
[KevinMarks]
there is a big chunk of activity streams for source control etc. Jira outputs AS1 of it still afaik not sure what consumes it
jacky, Guest6, barnaby, gRegor, [Ana_Rodrigues], ur5us, antrdnv[d], KartikPrabhu, ur5us_, Eddy04[d] and zachburau[d] joined the channel