We discussed creating a video in the quarterly planning meeting. I volunteered to work with Joel……. But I lost his contact info. (I’m sorry please email or slack me).
The original motivation was to provide targeted assistance to people who want to participate in docs sprint workshops, but need help with git/github. This has shifted a bit due to the great unknown of COVID. Also, I think instructions on running hugo locally would be helpful.
I think the videos would be a great asset. However, maintaining video content is more difficult that simple markdown text.
1. Splitting the content it into a small number of videos.
· The end goal would be a ‘learning path’ page or a youtube playlist
2. Using existing high quality content where appropriate (e.g., basics of git, basics of pull requests on github)
· Microsoft provides high quality github training on LinkedIn Learning (formerly Lynda.com)
· It’s proprietary :C
· Seattle Public Library provides free access to those with a library card
· There is also https://lab.github.com/ where you learn to use github interactively. Personally, I found this course very confusing even as a moderately knowledgeable github user. It’s done via a chatbot that creates issues for you on a sample repo.
· 🚩 If you know of any reliable git/github training, please send it my way
Initial draft outline:
1. The basics of git: a first commit on a local repo
2. The basics of github: fork, pull request
3. CNCF specific stuff: setting up upstream and main, signing the CLA
4. Building the site locally with hugo in a container
5. What’s in your stack? Interview with contribution who shares what tools they use (vi, vscode, extensions, etc.)
Ideally, the first two would be external videos. We’d create the rest.
🚩 Please provide feedback on the outline in this google doc https://docs.google.com/document/d/1SsSmSY9Eu4v8c75A1vnr0yKxjpyiuFZZLLo3W7eL6AA/edit?usp=sharing
Geoffrey Cline (AWS, Open Source Tech Writer)
🎉 I have a first draft of a video!
draft title: working on a personal fork
(unlisted video - please do not share)
🚩 please send me feedback! (youtube comments, #sig-docs slack, google doc below, email me, etc.)
As I said in the first email (below), the concept I have is to create a learning path that includes some existing "how to git" videos, and then gradually step more into CNCF/k8s/sig-docs specific content.
Here is the feedback I've received internally so far, that I plan to incorporate into the final version:
You received this message because you are subscribed to the Google Groups "kubernetes-sig-docs" group.
To unsubscribe from this group and stop receiving emails from it, send an email to kubernetes-sig-...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/kubernetes-sig-docs/7e812711-b292-4563-8c56-0acff653b0e7n%40googlegroups.com.
That’s a great point on youtube links to additional resources.
Here is a quick outline of what I used
I’m going to (eventually) type up a blog post with how I did this. I’ll further include a S3 link to the ~5GB premiere project which includes all the raw resources. I’m also looking at exporting the premiere project to an open format, but it looks like the open format is very basic, and would lose the green screen filter data.
CAUTION: This email originated from outside of the organization. Do not click links or open attachments unless you can confirm the sender and know the content is safe.