The video in the README looks like an image

[alexec]

I wanted to watch a video. You have a video. It's in the readme. It is not discoverable.

Better if the image had the video play icon on it. It looks like this was done correctly in the Markdown, but is not showing right.

https://stackoverflow.com/questions/11804820/how-can-i-embed-a-youtube-video-on-github-wiki-pages

[krancour]

@alexec I actually spent more time than I care to admit trying to properly embed the video in the README and even consulted the exact Stack Overflow page you linked to. What we did is the same as their accepted answer.

I still wish this were better, but I'm at a loss for how to do it.

Do you have an example of a README elsewhere on GitHub that has done this successfully?

[krancour]

Also, just fyi, the video is very stale at this point -- which is its own problem. Documentation text is up to date, however (but continuously improving).

[alexec]

Yah. Not sure why the recommended way does not have the usual "play" icon.

[krancour]

@morey-tech since you've been ramping up on doc improvements, I will tentatively assign this to you, but I'm not sure there's much that can be done here.

[krancour]

This video has actually be removed since it is so stale. We'll try to do a better job when we replace it shortly.