Slide decks and Instruqt code for Consul Workshops
MPL-2.0 License
All HashiCorp field workshops focused on consul should be placed in this repository. Similar field workshop repositories exist for these HashiCorp solutions:
Additionally, field workshops focused on more than one HashiCorp solution can be found in the field-workshops-hashistack repository.
The slides for these workshops should be created using Remark and should be placed under the docs/slides directory. This directory is organized by cloud and then by workshop. If a workshop targets a single cloud, its slides should be placed in a directory under that cloud's directory (aws, azure, or gcp). If a workshop can be used with multiple clouds, its slides should be placed in a directory under the multi-cloud directory.
Please do NOT place any slides or any other content directly inside the docs directory.
Standard assets (logos, backgrounds, css, fonts, and js) used by workshop slides are contained in a separate repository, field-workshops-assets.
When creating slides for a new workshop, you will need to do the following:
docs
under it.)index.md
and add all your slides to it.
consul-1.md
, consul-2.md
, and consul-3.md
with corresponding HTML files such as consul-1.html
, consul-2.html
, and consul-3.html
that should be copies of index.html
.index.md
with the name of the corresponding MD file in the sourceURLs
list. For instance, use consul-1.md
in consul-1.html
.index.md
in the sourceURLs
list of your workshop's copy of index.html
with a comma-delimited list of your MD file names. So, with the 3 MD files listed above, you would specify sourceURLs
like this:sourceUrls = [
'consul-1.md',
'consul-2.md',
'consul-3.md'
]
Whether you create a single-part or multi-part slide show, users will be able to access all of your slides with a URL like https://hashicorp.github.io/field-workshops-consul/slides/multi-cloud/consul-community/index.html, but they can leave off index.html
.
If you create a multi-part slide show, users will also be able to access each part of your slide show separately at URLs like these:
Each workshop should give the full link (or links) to that workshop's slides in one of its first few slides.
The instructor guides for these workshops should be created as Markdown files and should be placed in the instructor-guides directory and have names like <cloud>_<workshop_name>_INSTRUCTOR_GUIDE.md
where <cloud>
is the cloud the workshop targets and <workshop_name>
is the name of the workshop. But if the workshop is intended for use with multiple clouds, <cloud>
should be omitted.
The labs for these workshops should be created using Instruqt Tracks. Each track should be placed in its own directory directly underneath the instruqt-tracks directory. Doing this allows each track to be used by multiple workshops within this repository.