Documenting federation behavior in a semi-standard way?

You’re absolutely right, I should just be boost/Announce-ing those posts!! I just hadn’t thought of it.

1 Like

An Event is not an actor in my implementation. I try to be careful in the document about capital-E Event per the spec, versus an “event”, which is the thing that gathio describes. So:

  • an Event is an Object that is attached to an Activity and conforms to the AP spec
  • an event-the-thing-that-people-attend is an Actor; in this case I am representing it the actor as a Person because I don’t see a better choice (though maybe Service? I’m not sure that most implementations know how to represent that right now)
    • at this juncture I choose to interpret Person as an individual agent, rather than as an “individual person” per the AS Vocab spec

Great question. I’ll have to think about that. Right now your actors could still follow my actor and get normal public updates. But some correspondence between the human-actor and the event-actor should be private. I think they would simply have to go to the page and manually RSVP rather than doing it via federation.

Yes, definitely.

I will add the Accept/Reject/TentativeAccept Invite as a TODO to my list, along with the boosting that nightpool mentioned above.

2 Likes

Btw, the above todo items are done, and have been documented in FEDERATION.md :slight_smile:

1 Like

WriteFreely just added federation.md to their repo after I started a question about the behavior of what happens when one changes ones username.

1 Like

just updating this thread because I came across Zot’s new FEDERATION.md they just added and thought this would be a good place to post it…

1 Like

I added one to tavern and plan on keeping it updated: FEDERATION.md

2 Likes

I made one, too

1 Like

@nutomic and I will add one to lemmy once we get some time.

2 Likes

I have written up something like this for Lemmy

Yes, I saw the commit and already updated Guide for new ActivityPub implementers that has a list of impls with a FEDERATION.md (or similar) :smiley: And I added Smithereen earlier. If anyone else has one, pls update the wiki post.

1 Like

I’m thinking about a FEP formalizing FEDERATION.md file. Here’s how it might look like:

# FEP-67ff: FEDERATION.md

## Summary

`FEDERATION.md` is a file containing information necessary for achieving interoperability with a federated service.

## Requirements

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [RFC-2119](https://tools.ietf.org/html/rfc2119.html).

## Structure

The `FEDERATION.md` file can have arbitrary structure and content. The only requirements are:

- It MUST be a valid Markdown document.
- It MUST be located in the root of a project's code repository. If project's documentation is located in another place, the `FEDERATION.md` file may contain a link to that location.
- It SHOULD include a list of implemented federation protocols.
- It SHOULD include a list of supported Fediverse Enhancement Proposals (FEPs).

## Implementations

- [gathio](https://github.com/lowercasename/gathio/blob/a75aad783c117aaef2ec19b6b434be0f0d7e57de/FEDERATION.md)

What do you think?
@darius Since this was your idea, perhaps you will be interested in submitting such proposal?

2 Likes

This looks like a decentralized version of @gabek 's nascent https://fedidocs.org/ site. Gabe, should we consider making that site fetch and ingest FEDERATION.md files and be a central rendering clearinghouse?

2 Likes

@snarfed I suggested this idea in the context of improving grassroots initiative cohesion. The Delightful Club uses a mechanism to aggregate files from different repo’s and build an auto-updating site from that.

PS. I might also point out again the proposal to move FediDocs to the fediverse org on Codeberg where the FEP’s are hosted as well.

3 Likes

Technically, FEP-67ff: FEDERATION.md is finished, it is a part of my FEP collection: feps/fep-67ff.md at main - feps - Codeberg.org.

Should I submit it to the FEP repo?

Yes, it may help encourage the practice. Though FEDERATION.md is up for further improvement… maybe starting with having a template for it, for sake of consistency in documentation. There may be a few more impls. I update Guide for new ActivityPub implementers when I encounter one (but I didn’t revisit to see if they all still exist).

1 Like

Template… I like the idea.

Added it to my draft: feps/fep-67ff.md at main - feps - Codeberg.org

1 Like

The proposal has been submitted to the FEP repository. Discussion: FEP-67ff: FEDERATION.md

1 Like

Fwiw, I updated the Lemmy link.

Also, I flagged up that the link for Zot requires updating:

1 Like

I didnt get anything for this site:
https://fedidocs.org/

Did you mean this instead?:

Yes, the domain name has changed.