first draft of operations episode

[tobyhodges]

WIP - I want to add a figure for the life cycle before this gets merged. This is ready for review.

[github-actions]

Thank you!

Thank you for your pull request 😃

🤖 This automated message can help you check the rendered files in your submission for clarity. If you have any questions, please feel free to open an issue in {sandpaper}.

If you have files that automatically render output (e.g. R Markdown), then you should check for the following:

• 🎯 correct output
• 🖼️ correct figures
• ❓ new warnings
• ‼️ new errors

Rendered Changes

🔍 Inspect the changes: https://github.com/carpentries/lesson-development-training/compare/md-outputs..md-outputs-PR-47

The following changes were observed in the rendered markdown documents:

 17-operations.md         | 144 ++++++++++++++++++++++++++++++++++++++++-------
 fig/life_cycle.png (new) | Bin 0 -> 131034 bytes
 links.md                 |   2 +
 md5sum.txt               |   4 +-
 4 files changed, 129 insertions(+), 21 deletions(-)

What does this mean?

If you have source files that require output and figures to be generated (e.g. R Markdown), then it is important to make sure the generated figures and output are reproducible.

This output provides a way for you to inspect the output in a diff-friendly manner so that it's easy to see the changes that occur due to new software versions or randomisation.

⏱️ Updated at 2022-06-01 10:54:04 +0000

[tobyhodges]

The information I have included in this episode touches on the discussion in #25. My intention is that this new curriculum will render the Curriculum Development Handbook largely obsolete. We can provide an overview of the lesson stages here and go into more detail elsewhere e.g. in the community handbook or the documentation for the Incubator itself.

[zkamvar]

My intention is that this new curriculum will render the Curriculum Development Handbook largely obsolete.

Once this change happens, we should update the URLs introduced in carpentries/varnish#39

[sstevens2]

Few small suggestions but otherwise good draft.

[anenadic]

Great stuff @tobyhodges - ready to merge as far as I am concerned.

The only thing thing to consider adding at the end is a note on lesson translation/internationalisation just to make lesson developers aware. The internationalisation handbook uses Jekyll so it is not a match for the new lesson format and I am not sure how this is handled in the new Workbench. Still something worth pointing out?

[tobyhodges]

The only thing thing to consider adding at the end is a note on lesson translation/internationalisation just to make lesson developers aware. The internationalisation handbook uses Jekyll so it is not a match for the new lesson format and I am not sure how this is handled in the new Workbench. Still something worth pointing out?

This is definitely something worth mentioning in this section, but right now I am not completely sure what we can put in - there is a larger discussion taking place about how best to incorporate internationalisation into the Workbench and into our curriculum processes in general. Nothing is resolved yet but we are actively working on a plan.

For now, I am going to merge this PR and assign an issue to myself to add some info about internationalisation and translations to the episode when I have something more tangible that I can write.

[tobyhodges]

Thank you for the reviews @anenadic @sstevens2 🙌