The documentation for `Suggestion` entity is outdated

[anosidium]

Please update the documentation for Suggestion entity as it is outdated as it broke my Mastodon client, Oliphaunt. I found out that there are new cases for source attribute:

• featured
• most_followed
• most_interactions
• friends_of_friends
• similar_to_recently_followed

I don't know if there are any other new cases but these are the ones that I have found.

And the source attribute is now an array of String instead of just a String.

I am not too sure which Mastodon version these changes are effective but I think it might be from 4.3.0+, maybe 4.2.3+.

[andypiper]

Thanks for raising this as a documentation task. I think this was changed in this patch.

[trwnh]

Possibility of getting this changed upstream as it currently represents a breaking API change

[ClearlyClaire]

I unfortunately missed this change when reviewing #28314

We will restore the source attribute to a string consistent with what is currently described, and move the new attribute to sources.

See https://github.com/mastodon/mastodon/pull/29108

[andypiper]

Leaving this open, as we now need to document the sources attribute for the Suggestion entity.