Port to Workbench format

[multimeric]

Closes #217.

You can find the rendered HTML here: https://wehi-researchcomputing.github.io/docker-introduction/.

Feedback is welcome.

[multimeric]

Something I'm not sure about. The current material has objectives in the introduction page:

docker-introduction/index.md

Lines 8 to 20 in 15b3b4f

	> ## After completing this session you should:
	> - Have an understanding of what Docker containers are, why they are useful
	> and the common terminology used
	> - Have a working Docker installation on your local system to allow you to
	> use containers
	> - Understand how to use existing Docker containers for common tasks
	> - Be able to build your own Docker containers by understanding both the role
	> of a `Dockerfile` in building containers, and the syntax used in `Dockerfile`s
	> - Understand how to manage Docker containers on your local system
	> - Appreciate issues around reproducibility in software, understand how
	> containers can address some of these issues and what the limits to
	> reproducibility using containers are
	{: .objectives}

No workbench lessons seem to do this, and indeed the workbench won't even display objectives in the intro. Not sure if I should delete these entirely?

[multimeric]

I've also manually now checked all the output episodes, and I'm happy with everything. Nothing seems to have been missed.

[aturner-epcc]

Something I'm not sure about. The current material has objectives in the introduction page:

docker-introduction/index.md

Lines 8 to 20 in 15b3b4f

	> ## After completing this session you should:
	> - Have an understanding of what Docker containers are, why they are useful
	> and the common terminology used
	> - Have a working Docker installation on your local system to allow you to
	> use containers
	> - Understand how to use existing Docker containers for common tasks
	> - Be able to build your own Docker containers by understanding both the role
	> of a `Dockerfile` in building containers, and the syntax used in `Dockerfile`s
	> - Understand how to manage Docker containers on your local system
	> - Appreciate issues around reproducibility in software, understand how
	> containers can address some of these issues and what the limits to
	> reproducibility using containers are
	{: .objectives}

No workbench lessons seem to do this, and indeed the workbench won't even display objectives in the intro. Not sure if I should delete these entirely?

I think they can just be moved into the main text that appears at the top of the Summary and Setup page. It is important for learners to have an overview of what they will gain from the lesson so I would not want to lose them entirely.

[aturner-epcc]

Thanks for all the work on this, I will have a look through and add any comments in my review.

[multimeric]

I think they can just be moved into the main text that appears at the top of the Summary and Setup page. It is important for learners to have an overview of what they will gain from the lesson so I would not want to lose them entirely.

Currently I have it in a callout in this location: https://wehi-researchcomputing.github.io/docker-introduction/#after-completing-this-session-you-should. Let me know what you think.

[aturner-epcc]

That looks perfect! I'll go through the rest of the PR over the next day or two.

[aturner-epcc]

Initial review of code and rendered material looks fine. I am going to merge this in and then we can deal with any teething issues via individual fixes.

[multimeric]

Thanks for the merge! If you could run a github pages build too, that would be great.

[aturner-epcc]

I do not have permission to remove the gh-pages branch from the repo (it's existence is stopping the build from progressing as it pushes to this orphan branch). I have asked the repo admin (@sstevens2 ) to do this. If I don't not get a response soon, I will configure the build and publish to use another branch name.

[dme26]

Sorry there's a blocker for your work. Just double-checking that the default branch should become main, and if so I can effect changing the default and deleting gh-pages if sstevens2 isn't available.

[aturner-epcc]

Thanks @dme26 . main is good for the default branch name

[dme26]

I've changed the default branch to main and have renamed gh-pages to previous-gh-pages. Just let me know if this doesn't unblock your progress. (Also, apologies @sstevens2 if I just invoked any particular forms of repository chaos in so doing.)

[aturner-epcc]

Thanks @dme26. @multimeric Deployed pages has now updated to workbench format so I think this is all working now.

[sstevens2]

Hi all! Thanks so much for all your work on this! Sorry I missed it in my notifications. So excited to see this moved to the workbench!