search

crossplane / docs

Repo for Crossplane documentation.
https://docs.crossplane.io
Other
49 stars 109 forks source link

Add video tutorial content to docs site #727

Open jbw976 opened 6 months ago

jbw976 commented 6 months ago

What's Missing?

@vfarcic has produced some great tutorial videos on Crossplane recently. 2 parts of this series are available right now and they are being published to the following playlist: https://www.youtube.com/playlist?list=PLyicRj904Z99i8U5JaNW5X3AyBvfQz-16

Having these tutorial videos easily discoverable on the docs site would complement the existing getting started guides that are text based. The videos would be a great option for folks that learn better with video content. Hopefully this option will help accelerate their journey as well.

How best to expose this content on the docs site? Maybe they could be linked from the current getting started guide section. If they are not embedded with a full video player experience, they should probably at least be shown as a large thumbnail to help catch people's eyes as they are scrolling. Linking from multiple places would also help with discoverability.

plumbis commented 6 months ago

Great idea! We can embed the YouTube player directly in the page. May be a good reason to revamp the index/landing page and have this be front and center.

vfarcic commented 6 months ago

I also prefer to embed those videos instead of providing links but with one important note. Each has an accompanying link to the Gist with all the commands that people can use to follow along (copy and paste). I feel that's the critical part and I would suggest adding it to pages besides the embedded videos.