Embed Notice

@evan @DavidMarzalC I would have thought just looking at your notifications over the weekend would make it obvious that your documentation isn’t clear…

Not least - there’s a heading called “Opting out”, but not one called “Opting in”. You need to make it really clear that it’s an opt-in service, not one you need to opt out of any more (whenever you made that change). The language is technical and complicated, and assumes deep knowledge of ActivityPub. Again, for the reasons why you need to make it clearer, just look at your notifications.

The way I’ve always done documentation is from feedback. “Oh, person X thinks this service does Y. Why do they think that, and how can I make that clearer that it doesn’t?” I do this on every piece of feedback I get. Rewriting documentation and UX is never-ending; so that even if people only skim the headers they know how it works.