GESIS-Methods-Hub / andrew

Content Aggregation System for tutorials and vignette of reproducible computational methods.
https://gesis-methods-hub.github.io/andrew/
MIT License
2 stars 0 forks source link

Support presentation/slide version of tutorial #150

Open rgaiacs opened 1 year ago

rgaiacs commented 1 year ago

cc @schochastics @arnim @chainsawriot

@yfiua asked about support for presentation/slide version of tutorial.

At the moment, our workflow is

  1. Create container environment
  2. Convert .ipynb to .md which will be late converted to HTML by Quarto
  3. Convert .ipynb to .ipynb (we execute the cells)
  4. Convert .ipynb to .qmd (because some people prefer to work with plain text
  5. Convert .md to .pdf to have a friendly format to print

Can we convert the .ipynb to presentation/slide? Yes.

Will learners use the presentation/slide?

I think that learners will NOT use the presentation/slide.

Will instructors use the presentation/slide?

I think that instructors will need a patched version of the presentation/slide and will NOT use the version that we rendered.

Content Writing Challenges

Authors might need to use a lot of if-else blocks to tailor the content.

schochastics commented 1 year ago

You raise some good points here. I agree that slides are not a very good tool for self-guided learning. Also, there are other new formats such as pptx to consider.

Lets keep this issue open, but slides should have very low priority for some foreseeable time and direct rendered versions seem out of scope in general