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

Include Nextstrain tutorial videos in docs #78

Open
eharkins opened this issue Sep 17, 2021 · 1 comment
Open

Include Nextstrain tutorial videos in docs #78

eharkins opened this issue Sep 17, 2021 · 1 comment
Labels
documentation Improvements or additions to documentation proposal Proposals that warrant further discussion

Comments

@eharkins
Copy link
Contributor

Yesterday during a meeting, we talked about how there are a number of existing (and will be more in the future) tutorial-style videos on how to use various parts of nextstrain.

For example, the following two part series on ncov:

  1. running a build for sars-cov-2
  2. visualizing it in auspice

The above videos are great example of the question of how to include such resources in our docs. They are largely directly based on our documentation (in this case, the ncov tutorial).

I could imagine it would still be useful to put these videos into docs whether embedded [1] into RTD or as external links, since some folks may prefer video format.

However, it would be good to review these videos to make sure that they are up to date with the current version of the docs they are based on, and potentially update those docs as necessary to include key bits currently only in the videos.

And there's also the question of whether to include them in the tutorials section or have a separate section for workshop-style resources. I would think for simplicity to include them in the tutorials section in a way that clearly highlights them as a supplementary resource or alternative format for the tutorial.

[1] Embedding youtube videos in read the docs works like this in a .rst file (you can also wrap the iframe in a div to add styling e.g. margin):

.. raw:: html

    <iframe width="560" height="315" src="https://www.youtube.com/embed/ciGqAYT4d-4" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

The html code was copied from youtube by going to https://www.youtube.com/watch?v=ciGqAYT4d-4&ab_channel=Nextstrain and clicking "share" then "embed".

@eharkins eharkins added documentation Improvements or additions to documentation question Question about the project labels Sep 17, 2021
@cassiawag
Copy link

I agree that including them in the tutorials section as an alternative resource is a good way to go!

@victorlin victorlin added proposal Proposals that warrant further discussion and removed question Question about the project labels May 13, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation proposal Proposals that warrant further discussion
Projects
None yet
Development

No branches or pull requests

3 participants