vscode-docs
vscode-docs copied to clipboard
microsoft
Accessibility: Intro videos should provide open captions (subtitles)
Documentation does not meet accessibility requirements for users with additional access needs. The only format provided is video, where a transcript should also be provided:
E.g. https://code.visualstudio.com/docs/introvideos/codeediting
The video also does not play on Linux. Error code "We're sorry, an error has occurred when playing video (video failed to download)"
Hi @brownbonnie Thank you for entering an issue and your interest in the VS Code documentation. Our future video plans are currently under review and we appreciate your suggestion to add a video transcript.
We have been noticing a high number of user comments that the videos can't be viewed or heard but haven't been able to isolate the problem to a platform, browser, or geographical region. Could you tell us Linux and browser versions you are using when you get the error code? Also are you using an ad blocker?
Many thanks for your reply.
I was using: -Ubuntu 20.04.3 -Firefox for Ubuntu Version 93.0 (64-bit) -Ad blockers via Firefox extensions
Hi @brownbonnie I've upgraded my Linux machine to 20.04.3 and made sure I'm on the latest Firefox for Ubuntu 93.0 but I haven't been able to reproduce the video not running. I tried two popular ad blockers, AdBlock and AdBlock Plus, but they don't seem to cause an issue. Can you specify the ad blocker you are using? Thanks
Looking at recent comments, earlier in the month I see people saying the video won't play but not in the last two weeks. Could you try to watch the video again as I'm wondering if there was a server outage. Thank you for your help
I wonder if you are missing a video codec https://linuxhint.com/install_multimedia_codecs_ubuntu/
I see people recommending the ubuntu-restricted-extras to install codecs
Excellent thank you, yes I was missing the codecs. Following the guide you linked worked great.
Please could this issue be kept open for the accessibility side of things, e.g. transcripts. Many thanks :)
Glad you are unblocked. I'll add a note on the /docs/getstarted/introvideos page for Linux users in case other people hit this issue. Yes, we should keep this issue open. I've updated the title to call out the need for video transcripts.
Add mention of codecs installation with https://github.com/microsoft/vscode-docs/commit/fab0a96a9f7a3d38b0929552202ef97cd8604ca3
Hello. Apologies for leaving this comment here but I think it's related enough that I don't need to start a new issue. There is a word missing from the captions for this video:
It should say "…to have richer Intellisense…". I wonder if your video plans include open-sourcing the captions, from which the transcripts would presumably be drawn? This would allow for corrections such as this.
Thanks Hugh
@hughlilly Agreed - open-sourcing the captions could be a really good idea, assuming any changes would be peer-reviewed by the repo maintainers as per the usual process of course.
ToDo:
- caption every video with SRT generated by video indexer
- publish the SRT files to an public repository
- add a link to the SRT from the doc/video page
@gregvanl @brownbonnie The transcript can be obtained as follows:
I think the issue can now be renamed to 'Accessibility: Intro videos should provide open captions (subtitles)' or something similar.
There are errors in the subtitles, for example, in the introvideo 'Productivity Tips':
time stamp 01:08 caption: 'You can do the same thing with the add (+) sign to go to a symbol in a file.' correctly: 'You can do the same thing with the at (@) sign to go to a symbol in a file.'
time stamp 02:36 caption: 'You can also set Editor Format On Pace to True to format your text whenever you paste new text into your editor.' correctly: 'You can also set 'Editor: Format On Paste' to 'True' to format your text whenever you paste new text into your editor.'
time stamp 03:27 caption: 'You can trigger IntelliSense in any editor window by typing carrot space (^ ) or by typing a trigger character such as the dot (.) character in JavaScript.' correctly: 'You can trigger IntelliSense in any editor window by typing caret space (^ ) or by typing a trigger character such as the dot (.) character in JavaScript.'
In addition, I would like to add subtitles in Russian.
@chrisdias I created subtitles for introvideo «Productivity Tips» using «Azure Video Indexer»:
These subtitles are very different from the subtitles in the original introvideo.
I changed them manually:
Translation into Russian:
These subtitles can be used, but the timestamps are not set perfectly. Is it possible to get the original subtitles with the correct timestamps? Then you won't need video indexer!
I created subtitles for introvideo 'Getting started' which is embedded from 'Youtube':
in English ( @theReynald ) basics-en.srt
in Russian (my translation) basics-ru.srt
@gregvanl if I want to add videos to the documentation which screen recorder should I use? or what are the guidelines for recording such videos?
Closing old issue. Closed captions are available for the videos hosted on YouTube and www.microsoft.com. No plans currently to open source the captions or provide localized captions.