Update docs to describe raster-fade-duration's effect on rendering videos

[neodescis]

Partially addresses the documentation update requested in maplibre/maplibre-gl-js#2922. Will also open a PR in that repo to mention the property in video_source.ts.

Launch Checklist

• Confirm your changes do not include backports from Mapbox projects (unless with compliant license) - if you are not sure about this, please ask!
• Briefly describe the changes in this PR.
• Link to related issues.
• Include before/after visuals or gifs if this PR includes visual changes.
• Write tests for all new functionality.
• Document any changes to public APIs.
• Post benchmark scores.
• Add an entry to CHANGELOG.md under the ## main section.

[neodescis]

Now that I've made this change, I guess I should ask... Does this property affect video similarly in other things that use the spec, beyond GL JS?

[codecov-commenter]

Codecov Report

Patch and project coverage have no change.

Comparison is base (141ca39) 77.83% compared to head (f3fdf5f) 77.83%.
Report is 18 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #297   +/-   ##
=======================================
  Coverage   77.83%   77.83%           
=======================================
  Files         100      100           
  Lines        4105     4105           
  Branches     1176     1176           
=======================================
  Hits         3195     3195           
  Misses        910      910           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[HarelM]

THANKS!

[HarelM]

Like what?

[neodescis]

Like what?

What I mean is, do my new comments in the docs only apply to GL, or does native work the same way (with the fade in)? I've never used anything other than GL.

[HarelM]

They shouldn't, the spec should be cross platform, but just in case:
Cc @louwers

[louwers]

Since this source is not supported by MapLibre Native, it is clear that the description applies to GL JS only.

[louwers]

Yes so video sources are not supported by Native, that means the addition is not relevant for Native, but it will be once videos are supported. Fine to merge I think.