Suggestion: clarify visibility expectations in https://api.pleroma.social/#operation/StatusController.create
In https://api.pleroma.social/#operation/StatusController.create there is a note reading:
Visibility of the posted status. Besides standard MastoAPI values (
direct
,private
,unlisted
orpublic
) it can be used to address a List by setting it tolist:LIST_ID
It would be beneficial to developers were this to also include expectations of how this is used; I'd suggest...
Visibility of the posted status. Besides standard MastoAPI values (
direct
,private
,unlisted
orpublic
) it can be used to address a List by setting it tolist:LIST_ID
. Bots posting automated statuses are generally expected by the community to beunlisted
.
This would help new-to-the-fediverse developers like me to, at least, understand the community expectation here, and not put a big foot in it.
I'd make a pull request, but I don't actually know where the documentation lives.