Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add video of sharing exps via vs code #4865

Merged
merged 4 commits into from
Sep 22, 2023
Merged

Conversation

dberenbaum
Copy link
Contributor

This is a first attempt to start doing more regular updates to the docs that incorporate the newest vs code features. Open to thoughts on how to structure this. Should we use youtube videos? Should we record separate screenshots/gifs for these?

@shcheklein shcheklein temporarily deployed to dvc-org-vscode-product--tawrpm September 18, 2023 21:15 Inactive
Copy link
Member

@shcheklein shcheklein left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @dberenbaum !

@github-actions
Copy link
Contributor

github-actions bot commented Sep 18, 2023

Link Check Report

There were no links to check!

See the video below for how it all works using the [DVC Extension] for VS Code,
or keep reading to go deeper.

https://www.youtube.com/watch?v=UMVYjwJtRj0
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[Q] Did you rewatch this video to make sure it has the correct content? Should the link be to this one? Also... can we use a gif instead 😄 😬.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think @mattseddon is right here and this brings up an interesting question on language. The video Matt is suggesting is talking about "sharing" experiments to Studio, while the more recent one is about sharing with a colleague. Maybe we need to define language around this to be more clear? Maybe "sharing" should be used for collaboration things and we should use another term for sharing to DVC Studio? Cast to Studio? Send to Studio? Sync with Studio?

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

To be clear I don't think we need to redo the video. I could easily adjust the thumbnail, title and description wording.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[Q] Did you rewatch this video to make sure it has the correct content? Should the link be to this one?

🤔 I thought this was a good video for here because it goes end to end from adding the token, to pushing experiments, to sharing a studio link.

[Q] Did you rewatch this video to make sure it has the correct content? Should the link be to this one? Also... can we use a gif instead 😄 😬.

Up to you. My take would be that besides saving you form having to do two versions of product updates, having you talk through it is more helpful and easier to follow.

@jendefig
Copy link
Contributor

Open to thoughts on how to structure this. Should we use youtube videos?

We can use YouTube videos, but we may want to think about using the same content with Wistia. We would get really granular data on how people are viewing the videos on the page and we wouldn't have to see the not quite on brand/tacky YouTube thumbnails. Also for some reason our websites crop the YouTube links oddly instead of keeping them in their ratios.

I have to use best practices on YT thumbnails for YouTube (and am currently adjusting them to be less cluttered and show the people bigger), but they don't look that great on the website. And they don't autoplay, which might be better.

Copy link
Contributor

@jendefig jendefig left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewed in other comments.

@mattseddon
Copy link
Member

Can we use a screengrab instead?

Studio.sharing.mov

output

@dberenbaum
Copy link
Contributor Author

We can use YouTube videos, but we may want to think about using the same content with Wistia.

Up to you on that @jendefig

@jendefig
Copy link
Contributor

Can we use a screengrab instead?

This would be easiest, provided we do it so it autoplays like in the blog posts:https://iterative.ai/f045f6d718b6d1a25267598a06ef0558/dvc-part-update.gif

But do we think that it will be understandable enough with the text surrounding the video, without someone explaining?

@dberenbaum
Copy link
Contributor Author

But do we think that it will be understandable enough with the text surrounding the video, without someone explaining?

This was my worry, especially for the workflow in this video that has so many steps.

@jendefig
Copy link
Contributor

This was my worry, especially for the workflow in this video that has so many steps.

OK. So easiest is plugging in the YouTube video. Ultimately we should probably go with something like Wistia, But I see this as an after-next-funding kind of initiative due to opening another project right now with limited bandwidth.

We could also just use the original video auto-played, not inserting the YouTube one. The only thing I wonder about is will the audio be immediately running when it autoplays or will it be silent? cc: @yathomasi

@dberenbaum
Copy link
Contributor Author

We could also just use the original video auto-played, not inserting the YouTube one. The only thing I wonder about is will the audio be immediately running when it autoplays or will it be silent? cc: @yathomasi

@jendefig Do you want to wait on that or publish the YT one? It at least can drive people to the channel potentially, right 😄 ?

@jendefig
Copy link
Contributor

@jendefig Do you want to wait on that or publish the YT one? It at least can drive people to the channel potentially, right 😄 ?
Let's not hold up progress. Just publish the YouTube one. I'll make an issue to revisit this video issue about Wistia etc. And when we can accomplish/make a decision we can overhaul all of them.

@shcheklein shcheklein temporarily deployed to dvc-org-vscode-product--tawrpm September 22, 2023 15:37 Inactive
@yathomasi
Copy link
Contributor

@jendefig Let me know if your concern is addressed.

YouTube videos support features like autoplay, muted, loop, start at a particular time, etc. through parameters. (ref)

So, I have updated the link here to autoplay video(muted). If what you are seeking is different, let's discuss over the issue you have created:

@shcheklein shcheklein temporarily deployed to dvc-org-vscode-product--tawrpm September 22, 2023 16:23 Inactive
@dberenbaum dberenbaum dismissed jendefig’s stale review September 22, 2023 16:27

Approval of changes was noted in the comments

@dberenbaum dberenbaum merged commit 36395f1 into main Sep 22, 2023
3 checks passed
@dberenbaum dberenbaum deleted the vscode-product-updates branch September 22, 2023 16:27
@jendefig
Copy link
Contributor

YouTube videos support features like autoplay, muted, loop, start at a particular time, etc. through parameters. (ref)

Awesomeness! 😍 Thanks @yathomasi!!! This is great! I'll start shortening the length of the thumbnail time at the beginning and it will not be there for so long.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants