specification format

[ppwfx]

Im asking myself in what format the specification should be delivered.

Will it be something like a rfc?
https://tools.ietf.org/html/rfc7033

Could it be something like swagger?
Would be quite nice, as it allows to generate all the sdks
https://github.com/Chocobozzz/PeerTube/blob/develop/support/doc/api/openapi.yaml

[yookoala]

I think it makes more sense to have a format like RFC or W3C document like, again, ActivityPub. Swagger is great at describing RESTful API endpoints. But it does not describe the underlying logistics or workflow, which are essential for a protocol specification.

[bill-auger]

the mailing list is now fully functional - a thread has been started on the mailing list to continue the discussion in this issue - for those who are subscribed to the mailing list, check your email for the thread titled "specification format"; and reply to it to continue the discussion begun on this issue