Token is not really required for listening topics like public points reward redeems.

The scopes page on Authentication(https://dev.twitch.tv/docs/authentication/#scopes)

is missing the documented scope from the Helix Get Moderators

Returns all moderators in a channel.

Authorization
Requires OAuth Scope: moderation:read

https://dev.twitch.tv/docs/extensions/reference#helper-viewer


The Twitch.ext.viewer object is a collection of info about the twitch viewer that is watching the channel page where your extension is activated. It will only be populated if the viewer is logged in, and only after the `onAuthorized` callback has been called. Accessing its properties will otherwise return `null`.


Should be


The Twitch.ext.viewer object is a collection of info about the twitch user that is watching the extension view.


Or something, as the viewer helper object exists on all views!

The Get Broadcast Subscriptions docs https://dev.twitch.tv/docs/api/reference#get-broadcaster-subscriptions was updated to include gifterid and giftername fields, but neither of these were added to the example.

Also, the example is erroneous because it shows the same user id for both broadcaster and subscriber, but they represent different usernames, which is impossible.

https://dev.twitch.tv/docs/authentication

"Code samples are available here."

This line needs to be updated to point to different examples as the repo has been updated, for example for nodejs example its now at:

https://github.com/twitchdev/authentication-node-sample

not sure why someone decided it made sense to separate examples rather than place them in one repo

https://dev.twitch.tv/docs/authentication/getting-tokens-oauth#oauth-client-credentials-flow

There's no information about error response and it doesn't seem to be fully compatible with RFC 6749 which means I can't find info about possible errors easily.

https://dev.twitch.tv/docs/api/reference/#get-extension-transactions

Unlike other documentation, https://api.twitch.tv/ is omitted from the URL and the example call

Add parameter to enable dark mode for chat please.

Td

In the dev docs, can you add an "Updated" field with the date of when the page was last updated, or what versions the doc works with? Trying as a newbie now, there's some stale info in here.

From: https://github.com/twitchdev/issues/issues/72

Brief description

> By default, pop-out control is enabled for panel Extensions and for extension “live configuration views” (see the Live Config Path setting on the Asset Hosting tab in the Extensions manager).

https://dev.twitch.tv/docs/extensions/required-technical-background

The documentation suggests that extension developers can disable pop-outs. Which is not the case

From: https://github.com/twitchdev/issues/issues/70

Brief description

The documentation for creating signing JWT's don't explicitly state that user_id/channel_id in JWT's need to be an explicit string literal

https://dev.twitch.tv/docs/extensions/building/#signing-the-jwt
https://dev.twitch.tv/docs/extensions/reference#send-extension-pubsub-message

Expected documentation

Where:

exp is the Unix epoch timestamp when the payload will expire. Be sure to provide a buffer, to allow potential positive time drift.

user_id is the Twitch user ID that owns the extension, where the user ID is cast as a string literal.

role is set to external.

From: https://github.com/twitchdev/issues/issues/56

Brief description

Documentation describes that there are functions such as followChannel and requestIdShare but the documentation doesn't mention that these functions don't work in the rig (at time of writing)

https://dev.twitch.tv/docs/extensions/reference#helper-actions

Additional context or questions

https://discordapp.com/channels/504015559252377601/523676096277905419/676767529666084864

From: https://github.com/twitchdev/issues/issues/55

Brief description

https://dev.twitch.tv/docs/extensions/building#using-the-configuration-service

Doesn't mention the key bit of information regarding the size limit of 5kb

Additional context or questions

It's important to note here as people will start designing an extension and then discover the sizing limit late into construction of an extension. For clarity the limit should be noted here also

From: https://github.com/twitchdev/issues/issues/51

Brief description

https://dev.twitch.tv/docs/extensions/reference#helper-viewer

documentation wrong:

sessionToken

Twitch.ext.viewer.isLinked: string


The encoded JWT. This is the same as the token property of the authData parameter that currently gets passed to the onAuthorized callback.

Expected documentation

sessionToken

Twitch.ext.viewer.sessionToken: string


The encoded JWT. This is the same as the token property of the authData parameter that currently gets passed to the onAuthorized callback.

From: https://github.com/twitchdev/issues/issues/45

Brief description

Get Broadcaster Subscriptions doesn't describe how you can use an "App Access Token" for an extension that has sub status enabled, to use the end point

Expected documentation

Describe that an "Extension App Access token" can be used when a broadcaster has granted the "channel:read:subscriptions" scope via the Twitch Extension Manager

From: https://github.com/twitchdev/issues/issues/40

Brief description

https://dev.twitch.tv/docs/extensions/building/#using-the-configuration-service

Mentions "twitch api reference" but the config service endpoints are on in the Extension Reference

> For extension examples that leverage the configuration service see the new Twitch API Reference. Also, see these repositories:

Expected documentation

Links to <a rel="nofollow noreferrer" href="https://dev.twitch.tv/docs/api/reference">https://dev.twitch.tv/docs/api/reference</a> but the configuration API is documented <a rel="nofollow noreferrer" href="https://dev.twitch.tv/docs/extensions/reference#set-extension-required-configuration">https://dev.twitch.tv/docs/extensions/reference#set-extension-required-configuration</a>

From: https://github.com/twitchdev/issues/issues/36

Brief description

https://dev.twitch.tv/docs/extensions/reference#helper-extensions

The JS helper/callback function onPositionChanged is still documented but is no longer relevant post video component redesign

Expected documentation

Section Should be removed

From: https://github.com/twitchdev/issues/issues/31

Brief description

The documentation doesn't advise anything regarding what languages/localses exist/are valid to be called.

For example

https://dev.twitch.tv/docs/api/reference#get-streams

has a language query string argument, but doesn't advise what is valid for a langauge.

Expected documentation

Document the list of locales of if it matches a ISO, update documentation on endpoints using language/locale with a note about what is valid

Additional context or questions

Raised/queried on discord

https://discordapp.com/channels/504015559252377601/523675960797691915/664243349309620225