A year ago I tried learning ActivityPub, and more or less failed. I was confounded by a spec that was so abstract I couldn't make heads or tails of it. Turns out I was missing some key things.

I have written a guide to learning about ActivityPub that I wish existed a year ago when I first set out to learn how to write social media servers that conform to the spec:

@darius Me, too (failing to grasp it).

Looking forward to reading this.

@darius Nice write up. Gonna follow the plan you set forth and see where I end up. Thanks for this!

@darius I tried reading the spec and felt like someone was gaslighting me. Looking forward to reading your guide!

@annika Haha.

Spec: "It's easy!"

[Friendly cartoon diagrams]

Narrator: "It was not easy."


From the little I have read it looks like you put a lot of effort into making this clear and informative!

@Alonealastalovedalongthe I've been thinking about it for 6 months and then just vomited out all the words in one four-hour sitting tonight

@darius Hey this is very good! I still get tripped up by the fact that all this info is split among many documents; I'm glad there's now a guide for this.

@darius Thanks a ton for doing this write up. So far I haven't been super interested in ActivityPub at this level (spec and implementation) because from the outlook it seemed dense and hard to read. Now I know better!

@darius I don't really code anymore if I ever really did, and I'm not gonna write an ActivityPub implementation, but! I super appreciate what you're doing here!!

reading this, even without being personally invested in the thing you're helping other people do, I can immediately tell how helpful it is (and think of times I've tried to learn things when something like this would REALLY have helped)! thank you, this is cool

@darius @KitRedgrave I'm looking forward to it exploding in popularity and ending up on the n-gate Webshit Weekly writeup

mostly because the n-gate fellow doesn't seem to know anything about what he's talking about EITHER but at least he's entertaining about it (usually)

@darius @KitRedgrave and here I am still using FeedOnFeeds like someone who doesn't want to read an entire firehose of a timeline

@darius @KitRedgrave I mean I also follow a lot of folks and I don’t have the wherewithal to read everything posted by everyone. I also still think that the UX of any given RSS/Atom reader is a better match for my reading habits regarding long-form content.

@darius are there ways you think we can explain this better, systemically? When I first read the activitypub spec i thought the introduction was very clear and concrete, so I'm really interested in hearing the specific ways you were confused and how you think we can address those better in our writing.

@nightpool I've been flying today but I haven't forgotten about this. I'm compiling my thoughts into a document for you.

@darius I studied the ActivityPub spec for a small presentation. Your article really helped make sense of it all. Thanks! 🤗

@darius So basically when it comes to activity types: Actors are subjects, Activities are verbs, and Objects are objects, correct?

Sign in to participate in the conversation
Friend Camp

Hometown is adapted from Mastodon, a decentralized social network with no ads, no corporate surveillance, and ethical design.