#dev 2023-10-15

2023-10-15 UTC
#
aaronpk [tantek]: I am changing the post-process file to preserve more of cassis.js. The main reason I want it is to not deal with ob_start at all, so now I am doing only the steps necessary for that.
#
aaronpk (side note it would be great to rename the default branch)
bterry joined the channel
#
[catgirlinspace] ↩️ (especially when i have 0 experience........)
#
[tantek] oof re: default branch name. I somehow thought unaltered default branch names were all being auto-renamed and completely spaced on checking that. now renamed to main. thanks for the heads-up aaronpk++
#
Loqi aaronpk has 44 karma in this channel over the last year (114 in all channels)
#
[tantek] the GitHub Actions "Quickstart" is not quick
#
[tantek] https://docs.github.com/en/actions/quickstart
#
GWG Is there a set of guidelines on how to write a user story? I need inspiration
gRegor joined the channel
#
[tantek] GWG, there's a rough template like: "as a user, I want to complete specific_task, in order to achieve overall_goal"
#
[tantek] e.g. "as a home cook, I want to buy groceries, in order to cook dinner at home"
#
GWG I've just been playing with the Ticket Auth page since yesterday...on and off and it definitely needs more refinement and explanation
#
[tantek] Ticket Auth definitely needs user stories like that
#
[tantek] something like: "as a user, I want to publish a limited audience post, in order to have only my close friends able to read it"
#
GWG People keep misunderstanding what it is for and how it works, similar to it's parent.
#
aaronpk i mean, that's a perpetual problem regardless of how good the documentation is
#
GWG aaronpk: Yes, but I figure I might as well try. I do this all week at work...try to explain technical things to people...IndieAuth...airline reservations system....same difference.
#
aaronpk definitely still worth it! more documentation is better!
#
GWG I also want to intersperse the individual steps with the brainstorming on that step, instead of separately.
bterry joined the channel
#
[catgirlinspace] aaronpk any idea why telegraph isn't finding the url to http://fed.brid.gy in this post? https://catgirlin.space/activity/c9dc106025916c5a7293b393ca9d2c64/ has happened with lots of different posts when trying to get this to work >.<
geoffo joined the channel
#
sknebel [catgirlinspace]: I suspect it fails because your site does not send a Content-Type header
#
sknebel and its doing a bad job of surfacing the underlying error
#
[catgirlinspace] oops i should probably send a content type
geoffo joined the channel
#
[KevinMarks] https://x.com/sqiouyilu/status/1713409208878846134?s=20
Xe, geoffo and gerben joined the channel
#
omz13 [tantek] if you want user stories I did write https://omz13.github.io/indieauth-ticketing-dist/indieauth-ticketing.html#name-use-cases
gerben and monoob5 joined the channel
#
GWG omz13: I was the one looking
#
GWG Although I would like some opinions on the modifications I've made so far
[KevinMarks], gerben and [Jo] joined the channel
#
GWG omz13: Do you have any thoughts? I know you wrote a different protocol solution
geoffo, jeremycherfas, AramZS, gerben and btrem joined the channel
#
Renfield I'm having some trouble with h-entry. First, I wanted to just have a link with rel=author to my domain instead of putting a p-author h-card in every post. But validators don't seem to see that. They just notice it as a u-url.
#
GWG Renfield: Do you have something we can look at?
#
Renfield This is the link I was trying to validate with indiewebify.me and another one: https://lnx.graphics/posts/graphics_whishlist.html
#
Loqi [preview] [Arkdae] My Graphics Wishlist
#
Renfield Loqi finds my name at least.
#
GWG I'm not sure if indiewebify.me looks for rel=author
#
GWG Microformats parsing doesn't turn rel=author into p-author. That would be a post-processing task
#
Renfield The instructions there seem to indicate it should, "There should also be some way to discover the author of the post — either link to your homepage (which should have your h-card on it) from anywhere within the body of the page with rel=author, or optionally embed a p-author h-card in the h-entry."
#
GWG I turn rel=author to author in my code, but the parser wouldn't
#
Renfield Originally, I had the link with classes p-author and h-card. But then indiewebifiy.me didn't find my logo and such. Of course, because this isn't the complete h-card. The complete one is on the home page, which is what I would expect should be looked at to get all of that info.
#
Renfield Or, as author of a post, should I be filling out a complete h-card on each post?
#
GWG Renfield: Why not u-author?
#
GWG p-author is plaintext
#
GWG u-author would just indicate a url link to the author.
#
Renfield That would be because I didn't even know about the existence of u-author. I'll add that and see what happens.
#
Renfield I think it should have said rel=author class=u-author, if that's the way it should be written.
#
GWG You don't need both. u-author would convey it.
#
GWG How much fidelity do you want in your author property overall?
#
GWG Name, url, or both?
#
Renfield I guess I don't really know what I'm supposed to do.
#
GWG Renfield: It isn't supposed to per se. What information do you want to be interpretable?
#
GWG There is no one right answer, though there are common answers.
#
Renfield Everything in my homepage h-card.
#
GWG Yes, but I'm talking about the page you shared. The individual author properties?
#
Renfield I added u-author and indiewebify.me says, "You’re marking up your post’s author as a string — add h-card to make it a full h-card!"
#
GWG Is the URL of the homepage as the author good enough?
#
[tantek] Sounds like indiewebify is returning questionable guidance for use of u-author
#
GWG [tantek]: It isn't suggesting u-author. It seems to be suggesting p-author h-card.
#
Renfield I added h-card and now it is saying, "Add a photo!"
#
Renfield I don't want to add a photo, I want it to get my logo (not photo) from the h-card on my home page.
#
Renfield Yes, but I think p-author h-card is giving the same output as u-author h-card.
#
GWG I was suggesting just u-author.
#
Renfield I did that.
#
GWG I defer to [tantek]'s greater experience though.
#
[tantek] Yeah IndieWebify should be smarter about recognizing u-author and then fetching that
#
Renfield Okay! So I should just use u-author, and no h-card and that's considered good here?
#
GWG For me, it would. When I see just a u-author, I just go fetch that URL to find the h-card.
#
Renfield I'll do that.
#
Renfield Next question. I want to add e-content. I put it in the same element as h-entry. I don't think that works. Unfortunately, I don't have a sub-element to which I can put it.
#
GWG If you do, then the author and publish date is inside content...
#
Renfield I guess that is considered bad?
#
GWG Not bad.
#
Renfield I put the publish date after the title.
#
GWG It is more confusing.
#
Renfield Okay, I will see about adding an extra div.
#
Renfield Thanks.
#
GWG We've all been there, trying to figure things out
#
GWG But, basically, if you want the parser to be able to interpret the content separately from the other items...better to mark it up as such.
#
Renfield Should the summary be inside or outside the content?
#
GWG That depends. Is your summary a subset of the content, or completely different?
#
GWG If a subset, inside is fine. If completely different, outside
#
GWG Think of it this way...content is what you actually wrote. The other stuff is about what you wrote
#
Renfield I just made the first paragraph the summary.
#
Renfield It's markup, so it isn't trivial to convert this to have the right classes as far as I know.
#
GWG If the first paragraph is the summary, then having it inside the tag that has e-content is fine. It only doesn't make sense if it is a separate text.
GWG joined the channel
#
[tantek] Renfield, you cannot put a microformats property on the same element as the root class name. This is perhaps on of the top #microformats FAQs.
#
[tantek] Also in general a lot of the reasoning / questions / answers here are "tag wagging the dog"
#
[tantek] You don't start from markup design and then figure out what content to put in there. Completely the opposite
#
[tantek] You first figure out what content you want to display for yourself and your readers. Only second do you worry about how to mark it up. That follows directly from the decisions you've already made about content.