VIDEO-8954: Adding in extra links and details to the CHANGELOG entry

[PikaJoyce]

JIRA Ticket: VIDEO-8954

Team, this is a relatively small ticket that simply adds a bit more detail into our CHANGELOG with regards to the WKWebView release. Mostly some links and some shifting around.

Contributing to Twilio

All third party contributors acknowledge that any contributions they provide will be made under the same open source license that the open source project is provided under.

• I acknowledge that all my contributions will be made under the project's license.

Pull Request Details

Description

A description of what this PR does.

Burndown

Before review

• Updated CHANGELOG.md if necessary
• Added unit tests if necessary
• Updated affected documentation
• Verified locally with npm test
• Manually sanity tested running locally
• Included screenshot as PR comment (if needed)
• Ready for review

[anna-vasilko]

Few minor notes:

• Splitting into paragraphs would help, especially for the note on Safari
• Please add a detail ** track of each kind** to "WKWebViews only support only one local media track at a time" since it's one for audio and one for video
• I'd remove a link to Safari page since it is for really old Safari versions, it does not carry much value today

[sarahcstringer]

Looks good, I agree with @anna-vasilko's suggestions.

A few questions/thoughts

As some of the logic behind the isSupported flag relies on the User-Agent string, it should follow the correct format if your application is modifying the default value.

• This wasn't totally clear to me on first reading. Here's a slightly restructured sentence, does this capture what this is about?
  "The isSupported flag relies partly on the User-Agent header to determine if twilio-video.js officially supports the user's browser. If your application modifies the default value for the User-Agent heading, the string value should follow the correct syntax."

for iOS applications, your application will need to include the camera usage description, microphone usage description and inline media playback in order for the SDK to work on WKWebView.

• I'm not an iOS developer, so this might just be me not knowing things :) But it's not clear to me where you would need to specify this? Is there a link you could add or a sample of what this would look like?

[charliesantos]

+1 on Anna's suggestions.
Regarding Sarah's, I would rename

• User-Agent header to User-Agent string
• User-Agent heading to User-Agent string
• correct syntax to correct format
  "The isSupported flag relies partly on the User-Agent string to determine if twilio-video.js officially supports the user's browser. If your application modifies the default value for the User-Agent string, the new value should follow the correct format."

Let's ask @timrozum to provide example regarding
"for iOS applications, your application will need to include the camera usage description, microphone usage description and inline media playback in order for the SDK to work on WKWebView."

[anna-vasilko]

@PikaJoyce Re Known issues, could you mention that backgrounding / interruption issues being not unique to webviews but common to mobile browsers overall and point to our known issues page.

[charliesantos]

My comments have been addressed. +1 for me.