docker-introduction icon indicating copy to clipboard operation
docker-introduction copied to clipboard

Potential diagram of container run options

Open ChristinaLK opened this issue 4 years ago • 5 comments

I made this sequence of slides to illustrate the different ways to "run" a container.

https://docs.google.com/presentation/d/1nqF53xAeqgbONvTkuSs7Uqf5PicVZ0U1XYLnIu2Y-0k/edit?usp=sharing

Is this useful to add to the lesson, either as slides in the files folder or a single diagram in the lesson (or both)?

ChristinaLK avatar Dec 10 '20 03:12 ChristinaLK

The diagram looks great, definitely good to add some diagrams to the material, I think it could really do with some more visual elements to help illustrate the concepts.

I guess my only comment with this is whether using the term workflow as the example app/executable. Just looking at the diagram before really digesting it properly and seeing the term workflow, I assumed the three lines coming out of the bio-worfklow box were describing some sort of set of workflow tasks. That's not to say that others would make the same mistake but given that the bio-workflow name is not directly relevant to what's being illustrated, could this perhaps be renamed to my-app or something similar?

I also wonder whether it might be worth putting text on each of the three lines coming out of the box on the left saying option 1, option 2, option 3 to make it clear that these are different options for running a container?

jcohen02 avatar Dec 10 '20 10:12 jcohen02

I can rename the container/image, that's easy to do. Labeling the options also makes sense!

ChristinaLK avatar Dec 10 '20 13:12 ChristinaLK

I suppose that this idea might not fit with the carpentries/git-hub-pages template without modifications, but my way of showing this was to use a different background color for when we are running the docker container from "outside" rather than "dive into it" so that we are actually looking inside the container file system. You can see how this looks in my Docker lessons from last year:

DOCKER – BEGINNER FOR BIOLOGISTS https://bcrf.biochem.wisc.edu/docker-beginner-for-biologists/

You can take a quick look at this slide for the idea with 3 colors: https://static-bcrf.biochem.wisc.edu/tutorials/docker/docker_ioslides_01.html#10

This slide with 4 colors (one for alternate Terminal) https://static-bcrf.biochem.wisc.edu/tutorials/docker/docker_ioslides_04.html#22

jsgro avatar Dec 10 '20 22:12 jsgro

Different question - I like the idea of sharing both the slides and an image of the final slide.

I may ping the maintainers channel about recommendations for slide sharing.

ChristinaLK avatar Dec 10 '20 23:12 ChristinaLK

Agree with @jcohen02 about the renaming and options. Would you want to make a PR to the lesson with this change @ChristinaLK ?

sstevens2 avatar Mar 19 '21 18:03 sstevens2