documentation icon indicating copy to clipboard operation
documentation copied to clipboard

currently undocumented

Open trwnh opened this issue 2 years ago • 18 comments

webhooks

  • [ ] 4.0.0 admin webhooks https://github.com/mastodon/mastodon/pull/18510
  • [X] 4.1.0 account.approved webhook https://github.com/mastodon/mastodon/pull/22938
  • [X] 4.2.0 report.updated https://github.com/mastodon/mastodon/pull/24211

api

  • [x] 4.1.0 hide_collections param on PATCH account/update_credentials https://github.com/mastodon/mastodon/pull/22790
  • [x] 4.1.0 roles on Account entity https://github.com/mastodon/mastodon/pull/23255
    • https://github.com/mastodon/mastodon/issues/28327
  • [ ] 4.1.0 requested_by on Relationship entity https://github.com/mastodon/mastodon/pull/20785
  • [ ] 4.1.0 policy on WebPushSubscription entity https://github.com/mastodon/mastodon/pull/23210
  • [ ] 4.1.0 reading:autoplay:gifs on api/v1/preferences (but not update_credentials?) https://github.com/mastodon/mastodon/pull/22706/files
  • [ ] 4.1.0 use RoleSerializer for Admin::Account https://github.com/mastodon/mastodon/pull/23290
    • https://github.com/mastodon/mastodon/issues/28327
  • [X] 4.1.0 notifications limit raised from 15/30 to 40/80 https://github.com/mastodon/mastodon/pull/23348
  • [ ] 4.1.0 api rate limit per account 300 -> 1500 (new limit 300 per token) https://github.com/mastodon/mastodon/pull/23347
  • [ ] 4.1.0 streaming/metrics https://github.com/mastodon/mastodon/pull/23388
  • [x] 4.1.0 configuration.urls.status on api/v2/instance (the changelog is wrong, it claims v1 instead) https://github.com/mastodon/mastodon/pull/23390
  • [ ] 4.1.0 PUT /api/v1/statuses/:id now takes an extra media_attributes[] array parameter with the id of the updated media and their updated description, focus, and thumbnail https://github.com/mastodon/mastodon/pull/20878
  • [ ] 4.2 safeguard_mentions on POST /api/v1/statuses https://github.com/mastodon/mastodon/pull/18350
  • [x] 4.2 memorial on Account entity https://github.com/mastodon/mastodon/pull/23591
  • [ ] 4.2 trends management api https://github.com/mastodon/mastodon/pull/24257
  • [ ] 4.2 statuses/:id/history now returns at least one item when status is edited (the latest edit, at least) https://github.com/mastodon/mastodon/pull/25510
  • [ ] 4.2 mark conversation unread https://github.com/mastodon/mastodon/pull/25509
  • [ ] 4.2 forward_to_domains on POST /api/v1/reports https://github.com/mastodon/mastodon/pull/25866
  • [ ] 4.2 api/v1/instance/languages https://github.com/mastodon/mastodon/pull/24443
  • [x] 4.2 CredentialAccount entity now includes more params https://github.com/mastodon/mastodon/pull/26998
  • [x] 4.3 hide_collections on Account entity (used to show a different placeholder text) https://github.com/mastodon/mastodon/pull/27791
  • [ ] 4.3 allow_with_approval on email_domain_blocks API https://github.com/mastodon/mastodon/pull/28468
  • [ ] 4.3 Add api/v1/annual_reports https://github.com/mastodon/mastodon/pull/28693
  • [ ] 4.3 Add digest to admin/domain_blocks https://github.com/mastodon/mastodon/pull/29092
  • [x] 4.3 sources property on api/v2/suggestions https://github.com/mastodon/mastodon/pull/29108
  • [ ] 4.3 notification requests and policies https://github.com/mastodon/mastodon/pull/29366
    • [ ] 4.3 notification policies v2 https://github.com/mastodon/mastodon/pull/31343
  • [ ] 4.3 api/v1/timelines/link https://github.com/mastodon/mastodon/pull/30381
  • [ ] 4.3 filtered attribute on notifications https://github.com/mastodon/mastodon/pull/31011
  • [ ] 4.4 annual reports API https://github.com/mastodon/mastodon/pull/32709

things to test / document

  • [ ] setting an invalid in_reply_to_id when doing POST /api/v1/statuses https://github.com/mastodon/mastodon/issues/13473

env

  • [X] 4.1.0 SIDEKIQ_CONCURRENCY https://github.com/mastodon/mastodon/pull/19589
  • [X] 4.1.0 DB_POOL https://github.com/mastodon/mastodon/pull/23470
  • [ ] 4.1.0 MIN_THREADS https://github.com/mastodon/mastodon/pull/21048

tootctl

  • [ ] 4.1.0 media remove has new flags https://github.com/mastodon/mastodon/pull/22149
  • [ ] 4.1.0 accounts delete has new flags https://github.com/mastodon/mastodon/pull/22328
  • [ ] 4.1.0 accounts migrate https://github.com/mastodon/mastodon/pull/22330
  • [ ] 4.1.0 accounts prune https://github.com/mastodon/mastodon/pull/18397
  • [ ] 4.1.0 domains purge https://github.com/mastodon/mastodon/pull/22063
  • [ ] 4.2 new option for ip_blocks tootctl https://github.com/mastodon/mastodon/pull/24870
  • [ ] 4.2 tootctl accounts create has new flag --approve https://github.com/mastodon/mastodon/pull/24533
  • [ ] 4.2 tootctl accounts approve --number sorting was not guaranteed; now it is https://github.com/mastodon/mastodon/pull/24605

???

  • [ ] 3.3.0 object storage failure now returns 503 in some API methods
  • [x] ~~3.2.0 /api/v1/crypto added but commented out~~
    • [x] ~~4.3.0 removed entirely~~

user guide

  • [ ] "lock account" is now "require follow requests"
  • [ ] "list this account on the directory" is now "suggest account to others"
  • [ ] "hide your network" is now "hide your social graph"
  • [ ] change order of dropdown menu on posts to be more intuitive in web UI
  • [ ] change option labels on edit profile page
  • [ ] change max image dimensions (previously 1280px square, then 1920x1080 unless https://github.com/mastodon/mastodon/pull/23322 is merged, but then https://github.com/mastodon/mastodon/pull/23726 got merged)
  • [ ] can now upload webp, wave, avif, heic
  • [ ] custom emoji limit raised from 50kb to 256kb
  • [ ] authentication history
  • [ ] automatically delete old posts
  • [ ] filter search results by author, using from: syntax
  • [ ] hint about missing media attachment descriptions
  • [ ] timed mutes
  • [ ] private boosts
  • [ ] explore page
  • [ ] relationship manager
  • [ ] hashtag normalization
  • [ ] full text search params
  • [ ] attribution domains
  • [ ] lists

admin guide

  • figure out what's out of date, if any
  • [ ] 4.0.0 authorized_fetch tips need to be updated?
  • [ ] figure out SSO stuff
  • [ ] install guide - prefer SMTP_TLS over SMTP_ENABLE_STARTTLS? https://github.com/mastodon/mastodon/issues/23180
  • [ ] OpenID Connect support https://github.com/mastodon/mastodon/pull/16221

project dev guide

client dev guide

technical

  • [x] add CONTRIBUTING.md
  • [ ] note that mf2 (microformats 2) is removed?
  • [ ] nodeinfo?
  • [x] rss?
  • [ ] clarify stuff around ld sigs
  • [ ] clarify update_credentials vs preferences (especially when it comes to changing those values via PUT/PATCH) https://github.com/mastodon/documentation/pull/1152
  • [ ] clarify that ids are not "string representations of numbers" https://github.com/mastodon/mastodon/issues/25244
  • [ ] 4.2 toot:indexable flag https://github.com/mastodon/mastodon/pull/26485
  • [x] 4.2 memorial now federates as toot:memorial https://github.com/mastodon/mastodon/pull/26583

trwnh avatar Apr 30 '23 16:04 trwnh

@trwnh I started to check a few of these off based on some of the recent doc PRs (thinking the list items could be switched over to checklist items). Thanks for keeping this list here!

andypiper avatar Dec 10 '23 22:12 andypiper

Now switched to checklist format 👍🏻 just for convenience of checking things off as updates are merged.

andypiper avatar Dec 11 '23 14:12 andypiper

FYI, I'm tracking all the unreleased OAuth changes in #1445

ThisIsMissEm avatar May 17 '24 05:05 ThisIsMissEm

HI Emelia,

I'm not sure why I subscribed to that thread or even if I did. I work with the Ambassador Program. Is there any way for you to delete me from the thread? If not, could you give me a spot to start and I will remove myself.

Sorry for any needless work you've had to do. I appreciate your time, though.

Thanks!

On Fri, May 17, 2024 at 12:17 AM Emelia Smith @.***> wrote:

FYI, I'm tracking all the unreleased OAuth changes in #1445 https://github.com/mastodon/documentation/pull/1445

— Reply to this email directly, view it on GitHub https://github.com/mastodon/documentation/issues/1211#issuecomment-2116659406, or unsubscribe https://github.com/notifications/unsubscribe-auth/ABAVF7CZLQTKIMXLHHQRE6LZCWHHBAVCNFSM6AAAAAAXRA62JGVHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMZDCMJWGY2TSNBQGY . You are receiving this because you are subscribed to this thread.Message ID: @.***>

-- Sincerely, Colleen Ambassador for SingularityNET.io ​'X' = @colleenpridemor 224.805.2281

This message may contain confidential and/or privileged information. If you are not the intended recipient or authorized to receive this for the intended recipient, you must not use, copy, disclose or take any action based on this message or any information herein. If you have received this message in error, please advise the sender immediately by sending a reply e-mail and delete this message. Thank you for your cooperation. @.*> http://www.linkedin.com/in/kalidrane

colleenpridemore avatar May 17 '24 11:05 colleenpridemore

@colleenpridemore at the bottom of the email from github there's an unsubscribe link, or on web in the sidebar of this issue you can manage your subscription – I can't managed that for you

ThisIsMissEm avatar May 17 '24 13:05 ThisIsMissEm

Docs for 4.3 Add digest to admin/domain_blocks https://github.com/mastodon/mastodon/pull/29092 are in https://github.com/mastodon/documentation/pull/1417 which is merged.

ThisIsMissEm avatar May 17 '24 14:05 ThisIsMissEm

On 4.1.0 streaming/metrics, I've started docs here, since between 4.1.0 and now, we've switched Streaming to use the proper prometheus module: https://github.com/mastodon/documentation/pull/1213

I also have a grafana dashboard for Streaming metrics, but I don't know how to make this distributable; but that could go in dist/ in the main repo then

ThisIsMissEm avatar May 17 '24 14:05 ThisIsMissEm

Another undocumented endpoint seems to be Api::V1::Timelines::LinkController at GET /api/v1/timelines/link

ThisIsMissEm avatar Jun 09 '24 16:06 ThisIsMissEm

Since 325dc1fc036aff3d19491d326ee7bf0208ee5e3f, you may tick off CONTRIBUTING.md.

aaaaalbert avatar Aug 08 '24 21:08 aaaaalbert

https://docs.joinmastodon.org/entities/Instance/#registrations

registrations[url] is currently undocumented (/app/serializers/rest/instance_serializer.rb#L106)

Reeceeboii avatar Aug 24 '24 15:08 Reeceeboii

For reference, the above registrations[url] was introduced by this PR: https://github.com/mastodon/mastodon/pull/25014

shuuji3 avatar Aug 24 '24 15:08 shuuji3