Note, overview/landing pages should have the yaml file header, e.g.,:
---
layout: page
title: AWS overview
---
#
header style.
Add Title Here¶
Add a brief description of what the tutorial is about. If tutorial material was built from other sources, mention that here.
For multi-page tutorials only, add estimated time per section, lesson name, and description in a Markdown table:
Est. Time | Lesson name | Description |
---|---|---|
x mins | Page title | Formatted as a short phrase or question about the primary learning goal of each section |
y mins | Page title | Shorter tutorials may have only one entry |
Learning Objectives
The objective(s) of this tutorial are to:
-
objective 1
-
objective 2
For 1-page tutorials only, add a tabbed box for the "Est. Time" (it should be grouped with the prereqs and tutorial resources tabs):
x mins
- Operating system(s)
- Required installations
- Setup steps needed to complete the tutorial
- list out resources with bullet points and include a hyperlink to the resource (e.g., vidlets, screencasts, example files, cheat sheets)
For longer tutorials that are split over multiple pages, start the next sections on a NEW page.
Introduction (optional)¶
If more introductory material is needed beyond the brief description on the landing page, please add an introduction section.
Set Up (optional)¶
If more set up material is needed beyond the prerequisites section, please provide additional instructions in a Set Up section (e.g., on computer set up, software installations, and/or specific tutorial file downloads (may include linking to existing tutorials)).
Step 1: do this¶
Step 2: do that¶
Step 3: change this¶
Conclusion (optional)¶
If applicable, briefly sum up the tutorial key points as a bullet point list (it could be a recap of the learning objectives). In some cases, it may make sense to have a "Conclusion" section and in others, a "Key Points" admonition box is sufficient.
Use the admonition format:
Key Points
- point1
- point2