#[eddie]aaronpk: Should Watchtower have some type of environment variables file? (https://github.com/aaronpk/Watchtower) I’m not seeing any example environment file or anything but I know it’s supposed to have an API key
#Loqi[aaronpk] Watchtower: a minimal API for watching web pages for changes, roughly speaks the WebSub protocol
snarfed, [miklb] and tantek joined the channel
#loqi.mecreated /SB (+146) "prompted by tantek and dfn added by tantek" (view diff)
#Zegnat!tell aaronpk Why does IndieAuth have the response_type parameter? There doesn’t seem to be a way to check if the auth code is being checked by the client (for ID) or by a token endpoint (for authz), to from the authorization endpoint there really is no difference between `id` and `code` requests. Or am I missing something?
#Loqiaaronpk: Zegnat left you a message 3 hours, 21 minutes ago: Why does IndieAuth have the response_type parameter? There doesn’t seem to be a way to check if the auth code is being checked by the client (for ID) or by a token endpoint (for authz), to from the authorization endpoint there really is no difference between `id` and `code` requests. Or am I missing something?
#ZegnatYou could on verification have the authorization endpoint say for what type it issued its code. If it isn’t `code`, but `id`, a token endpoint could refuse to issue a token. Was my first thought.
#aaronpkif the client doesn't request a scope, the authorization must set a default or reject the request
#aaronpkso the token endpoint should not issue a token if the auth code verification step returns an empty scope
#ZegnatYeah, that last paragraph of that section really sneaks up on you, ha
#aaronpkand response_type=id vs code tells the authorization server whether or not to include a scope in the auth code
#ZegnatYes, seems fine now. So auth endpoints for response_type=code always set a scope, and token endpoints for no scope on code verification should not issue a token.
#aaronpkyep, those notes seem worth adding to the spec
#ZegnatI’m about to get something to snack, when I get back to the keyboard I’ll file these as separate issues.
#ZegnatThis was one of those things that came up working on my token endpoint :) I was wondering how to make sure I wasn’t issuing tokens for authentications.
#[eddie]manton The current build I’m working on adds publishing “notes” which follow the standard micropub `content=` (https://indieweb.org/Micropub#New_Note) So that I’m assuming to work with micro.blog out of the box
[manton] joined the channel
#[manton]eddie Excellent, thank you. And if you were watching the stream, apologies for completely mispronouncing Indigenous. 🙂
#[eddie]haha, no worries. I change the pronunciation every time I say it 🙂 Which isn’t often since most my discussions happen on the internet 😄
#[manton]Notes should definitely work with Micro.blog now. I'm working on mapping bookmark-of to Micro.blog favorites today... It's not all a perfect mapping but I think it's the place to start.
tantek joined the channel
#ZegnatHow are Micro.blog favourites different from Micropub/mf2 bookmark posts?
#LoqiTogether is a reader that was initially conceived at the 2017 IndieWeb Summit in Portland by Jonathan LaCour and several others during the Putting it all together session https://indieweb.org/together
#[eddie]manton awesome. Yeah I think bookmark and favorites is a pretty good pairing.
#[eddie]Zegnat: favorites aren’t public ally displayed
#[eddie]So a favorite is a visibility private bookmark
#[manton]That sounds right. I may end up renaming Favorites to Bookmarks. Although then the "star" icon makes less sense, so I'm not quite ready to do that.
#[manton]Something like this is what I was thinking this morning if we wanted a way to discover types and have them adapt to whatever names a Micropub endpoint used... The concern raised is that it could become kind of too abstract and complicated. https://gist.github.com/manton/bc51805cf421ba45b13cd7214f48a034
#[manton]Yep. In the case of Reeder they actually call them "Starred Items".
#aaronpk[manton]: the trick with that is those properties depend on the vocabulary, so those actually are saying which h-entry properties the server supports. if a server supports h-event, then you also want to know that, and also which properties in h-event are supported. so this quickly gets out of hand.
#[manton]Hmm, yeah... I'm coming at this from the simpler actions (really from just thinking about what the user sees), but that's a great point.
#[eddie]manton if through brainstorming you are able to come up with a good potential solution to the posting type discovery, and make micro.blog a publisher, I’d be happy to make indigenous a test consumer, because while complicated I do think that information is an important next step in our tools as more Gen 2/3/4 come into IndieWeb tools and it becomes difficult to explain why Quill or Indigenous has all these interface options that break or donâ€
#[eddie]Like tantek said when talking about photo person tags, brainstorming and then testing is the only way to find out what works and what doesn’t
#[eddie]I think the key would be making sure the consumer (the Micropub app) if it doesn’t find the mp types configuration, it defaults to everything being available.
#ZegnatI wonder if there is some way to specify the post types (as per https://www.w3.org/TR/post-type-discovery/) that are supported by the Micropub endpoint, rather than specifying the exact properties it expects.
#ZegnatInstead of what [manton] showed where he used “repost-of” (which is a property), or exposing what root h-* objects are supported, just tell the client what types the endpoint can create.
#ZegnatThough not sure how useful that would actually be.
#tantekyeah that's kinda the problem, it goes down the type discovery rathole
#ZegnatJust a random thought I had. Was reading the chat backlog while waiting for dinner.
#LoqiThe monoculture antipattern is best described as, if only everyone would install and run this one open source project then we will be good https://indieweb.org/WS_Deathstar
#[eddie]Yeah, it’s tough. But I think ultimately h-roots and properties are really what the Micropub clients need to know in order to know what to send and what not to send
#[eddie]I think h-entry is really the biggest fluctuating h-based item, so I wonder if you somehow define the h-types and then just the h-entry properties and assume all properties for anything not an h-entry?
#Loqi[Tantek Çelik] h-entry is a simple, open format for episodic or datestamped content on the web. h-entry is often used with content intended to be syndicated, e.g. blog posts. h-entry is one of several open microformat standards suitable for embedding data in HTML.
...
#[manton]Yeah, I see the slippery slope to WSDL if we go down that path... I was really just thinking about what the user sees, e.g. "Does this server allow me to bookmark something?"
#tantekmanton, is it so bad if the server only allows the fallback behavior?
#tantekthe interesting thing is, in practice the fallback summary text is unique enough per existing response type that their simple fallback reply posts could get upgraded in the future
#tantekis unlikely to match any false positives that were not intended as /bookmark posts
#[manton]I hadn't thought about it until today... If Indigenous (for example) will eventually show 5-10 different options for the user, what would they expect to happen if they choose "RSVP" or some of the less common ones. Not sure.
#ZegnatYeah, that's what gRegorLove does for his read posts. Makes sure to have a fallback value for the post in the content property
#[manton]Aaron proposed that "summary" might be better for a fallback in some cases. I just checked and Micro.blog actually ignores summary at the moment, although that's easy to change.
#Loqi[gRegor Morrill] Martijn asked if I had documented the micropub request I make for read posts. I had not yet, so decided to make some quick notes while it's fresh in my mind.
Currently, it sends an h-cite object with properties: status, url, name, author, and isbn....
#Loqiwebmention has 1 karma in this channel (3 overall)
#Loqi[gRegor Morrill] Martijn asked if I had documented the micropub request I make for read posts. I had not yet, so decided to make some quick notes while it's fresh in my mind.
Currently, it sends an h-cite object with properties: status, url, name, author, and isbn....
#tantek.comedited /tag-reply (+138) "/* Facebook notifications */ screenshot of when someone person-tags you in a photo" (view diff)
#tantek.comedited /tag-reply (+91) "/* Facebook notifications */ person-tag reply notification text from email" (view diff)
#gRegorLoveZegnat: Oh yeah, thanks for the reminder to check my URL discovery. I think it trimmed the trailing slash off your URL for some reason, so found the wrong endpoint
#LoqiAn edit (AKA diff, change) is a special type of reply that indicates a set of suggested changes to the post it is replying to. A collection of (presumably related) suggested edits in open source is often called a patch or pull request https://indieweb.org/edit
#tantekok now that I've loaded into my head how /tag-of (including /person-tag reply) posts could/should work, and deduced that they really are a special variant of an /edit post, I've documented what I figured out to hopefully make more incremental progress on that next time
#tantekthat's too much to try to implement in less than two hours, but definitely glad I worked through a bunch more of the details (added to research on /tag-of silo examples and brainstorming) and made the connections between /edit/tag-of/location-of and /untag
#tantekso that's it for that attempted new feature (for today), back to the "easier" problems
#tantek.comedited /Falcon (+123) "/* one-off person-tag response to photo */ example aaronpk check-in I could try person-tagging with manton" (view diff)
#tantek.comedited /tag-reply (+114) "/* person tag reply */ interested in implementing, link to Working On subsection with details there" (view diff)
#tantekyou're safe for today aaronpk, you won't be getting any person-tag reply posts from me just yet. but I have uncovered more of the key details in how to do so, including how to implement it in /Falcon in particular, so next time I may have better luck
#sknebelhm, untag would also somehow contain hiding the /untag post
[manton] joined the channel
#[manton]eddie One thing I ran into while testing Indigenous... I had to add NSAllowsArbitraryLoads to the Info.plist for the share extension. The OS was never letting the app hit Micro.blog's Micropub endpoint.
#aaronpkstart with what you'd publish on the post, and how you'd mark it up in h-entry
#sknebelso not post types in general, only cites? and the client would know that it should offer to create those properties with h-cite?
#gRegorLoveIt's not marked up in the h-entry currently, just text prefixed to the h-cite, and included in the e-content / summary properties so the fallback is human friendly.
#gRegorLoveThe options exist in the forked Quill form already, they're just hard-coded.
#sknebelhm. sort of like templates for different post types
#gRegorLoveIt gets sent in the mf2 as property 'status'
#gRegorLoveSimilar, but this property affects content that appears in the post, isn't about the status of the post itself / where it should or should not appear.
#gRegorLoveIt's like the action you're indicating on the thing you're citing.
#gRegorLoveI want to read x, I'm currently reading y, I finished reading z
#LoqiTo read or reading is the act of viewing and interpreting posts or other documents; on the IndieWeb, a read post expresses that something has been read, like a book or section thereof https://indieweb.org/read
#gRegorLoveSo q=read-actions, or does the querying idea itself seem off?
#aaronpkthe query idea isn't necessarily wrong, but I am somewhat skeptical that it's necessary
#aaronpkit seems like there will likely be a set of terms agreed on by people who are posting read posts, and a client can just hardcode those
#aaronpkthe idea with the query API is it's for things that *can't* be hardcoded in a client, like the list of syndication endpoints
#gRegorLoveHm, yeah. i18n was the initial thought process behind it.
#aaronpkwhat you're seeing is the problem with trying to start at the Micropub level rather than starting at the Microformats level
#aaronpkif you start with microformats and define a vocabulary and publishing and consuming use cases, then it becomes more straightforward in micropub
#gRegorLoveWell, I had plenty of /read posts before I started with this. Called them citations since it was using h-cite.
#gRegorLoveSo publishing uses cases were there, not consuming though
#aaronpk"...to notify the author of a document that you have read it"
#aaronpkso in that case, you'd want the book URL to understand the difference between "have read" and "want to read", so those are good consuming use cases for read posts
#gRegorLove/read is heavily worded towards reading URLs, not so much books.
#aaronpkin order for that to work, there needs to be a common vocabulary of those terms
#aaronpkif there is a common vocabulary, there is no need for querying the list of options
#gRegorLoveAnd currently the URLs are my local isbn redirects, so notifying them doesn't seem important to me.
#aaronpkyou see where I am going with this though, right?
#gRegorLoveI'm definitely using it for the first use case there "to share books, etc. with followers" and eventually to track metrics for myself, like # of books read.
#aaronpkokay so imagine there was an aggregator that collected /read posts from a bunch of people
#aaronpkit would want to group them based on "have read" or "want to read" and other variations
#aaronpkso you also want that common vocabulary of statuses for that purpose
#gRegorLoveSure, that makes sense. It seems odd that I need to work backwards from an aggregator that doesn't exist, though.
#gRegorLoveDon't worry, not pursuing the q= option currently.
KartikPrabhu joined the channel
#aaronpkso if I take your example post, i'd imagine seeing something like <div class="e-content"><data class="p-read-status" value="want-to-read">Want to read</data>: <em class="h-cite"> ...
#Loqi[gRegor Morrill] Martijn asked if I had documented the micropub request I make for read posts. I had not yet, so decided to make some quick notes while it's fresh in my mind.
Currently, it sends an h-cite object with properties: status, url, name, author, and isbn....
#gRegorLoveWhich sounds like it isn't quite the right way to proceed.
#gRegorLoveYeah, I'm thinking mf2 values: reading, want-to-read, finished-reading as a starting point.
#aaronpkyeah I would expect that you're posting an h-entry, so that you get the regular post properties published/author/content/etc. then like a bookmark-of adds additional data, you're adding additional info about the thing you're reading and your read status. so your h-entry could include a "p-read-of" property that is an h-cite that describes the thing you're reading.
#gRegorLovep-read-status on the h-cite, then? or on the h-entry?
#aaronpkon the h-entry. h-cite is just describing the thing you're reading
#ZegnatHuh. Loqi seems smarter than the PHP Microformats parser? It added a space between “Want to read:” and “Typewriters:” that I am not seeing on microformats.io
#gRegorLoveDarn whitespace collapsing around <data> in the parsed p-name though.
#ZegnatThe spec also gives descriptions for use-cases for all three, but I tend to forget those specifics. For I it still mentions books I believe.
#aaronpk!meme the-more-you-know.gif [the more you know meme]
#ZegnatCITE seems fine too. Though I am not sure how CITE is currently described, I recall some sort of web-dev petition in the early HTML5 days about its usecases.
[manton] joined the channel
#[manton]eddie Actually it needs to be added to the Info.plist for the sharing extension, too, not just the main app.
#[eddie]manton ohhh. Well in the new build you can also post from the main app, so I’m guessing it’ll be needed then?
#gRegorLoveOk, updated that previous book link to use cite.
#[manton]Oh cool, I didn't realize that. Yeah, I think it should be in all Xcode targets.
#[eddie]Ohh I see what you mean. I don’t think it’s in the Share ext at all, so I do need to add it there
#[manton]As aaronpk commented to me, I need to fix whatever is weird with Micro.blog's SSL certs so that Apple accepts them, but I think this Info.plist change is good until more people support https.
#[manton]I'm thrilled with the way Apple handled this... I wish there was some feedback to the user when it's not https or there's an issue with the cert.
#@rMdes_... Get a webmention like ping that push your new address to their system and voila. You want to vote? ID with your NFC phone + a paper vote uniquely generated for you, login, vote, you can choose to make your vote public in the ledger or not and stay anonymous but authentified (twitter.com/_/status/939982249386225664)