Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jargon-buster presentation #377

Merged
merged 19 commits into from
Feb 9, 2022

Conversation

reid-a
Copy link
Contributor

@reid-a reid-a commented Feb 1, 2022

No description provided.

@reid-a reid-a changed the title First draft of the jargon-buster presentation. Jargon-buster presentation Feb 1, 2022
reid-a and others added 13 commits February 2, 2022 09:54
Added a slide to discuss scale-up generally, with a photo
of a real data center. Re-ordered things so the laptop
comes first -- familiar grounding.  Made edits to the
pdfpc comments to help focus on the terminology as well
as the scale-up landscape.
Added a workstation to the "laptop" slide, making it the
"standalone" slide. Removed "+smart" from the Makefile's
pandoc invocation, my pandoc doesn't know this argument.
@bkmgit
Copy link
Contributor

bkmgit commented Feb 3, 2022

This is nice. Would suggest not using PDF as default, but instead use HTML slide software such as:

An example presentation https://bkmgit.github.io/simple-slides/

@reid-a
Copy link
Contributor Author

reid-a commented Feb 3, 2022

The benefit of PDF and the pdfpc tool in particular are that it allows for a "presentation console", where speaker notes are available to the presenter. This helps to ensure that all of the relevant points actually get mentioned to learners, without requiring a large amount of text on the slides themselves.

This is high-value, I think, although we have already had some portability issues, newer pdfpc implementations apparently don't use the same notes file format as the one used to compose this initially.

If there is an HTML slide tool that can show notes to the presenter, that would be a good solution.

Technically, it's easy to add new targets to the makefile, of course.

@bkmgit
Copy link
Contributor

bkmgit commented Feb 3, 2022

Notes functionality is available or can be added if one wants to use a custom template. Carpentries typically discourages lots of slides since the pace may be too high. Some introductory and overview concepts might be better presented that way though instead of through the lesson material.

reid-a and others added 5 commits February 3, 2022 11:33
Removed the mainframe slide, re-ordered so the cloud comes
before HPC, and added an HPC workflow schematic.
Per @bkmgit's advice, this commit refactors the jargon buster
presentation to use the Remark presentation framework instead of the
pandoc->beamer->pdfpc toolchain. The presentation content remains
pure Markdown, with a concise HTML wrapper providing the Remark
framework. The slides can be shared in presentation or notes mode,
and toggled between by pressing `P`.

Images have been rescaled to accommodate. SVG inputs would be
preferred, but that is an undertaking for @reid-a.
refactor jargon buster for remark
Copy link
Contributor

@tkphd tkphd left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

Note that the repo currently contains both the original Inkscape-to-PNG images and resized versions. Since the slides are now HTML (not PDF), direct use of the SVG would be preferable., but that's not necessarily a gating item.

@reid-a reid-a merged commit 183482a into carpentries-incubator:gh-pages Feb 9, 2022
@reid-a reid-a deleted the add-jargon-presentation branch February 9, 2022 01:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants