Good morning. The sun is shining.
Does somebody feel like doing a huge service to the Fediverse developer community? I got just the issue for you. First, I consider this to be difficult to do well. One needs to pick good names for stuff, in order to lessen the amount of generated confusion (see discussion and link). Second, I consider this easier than actually documenting/specifying the behavior correctly. That's because Gherkin/BDD is documentation by example. So it's enough to provide examples that tell a good story.