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

AIO, Google docs exporter, Etherpad Exporter #432

Open
Denubis opened this issue Sep 16, 2019 · 4 comments
Open

AIO, Google docs exporter, Etherpad Exporter #432

Denubis opened this issue Sep 16, 2019 · 4 comments

Comments

@Denubis
Copy link

Denubis commented Sep 16, 2019

In preparation for migrating (As per discussion in #431) my etherpad (and now google-docs) exporters to the universal style, what features, capabilities, and endpoints are desired for us to quickly produce note-taking documents for participants in our workshops? Do any of these features not exist in the demo documents:

Instructor training etherpad:

https://carpentries.github.io/instructor-training/etherpad/index.html -> https://pad.carpentries.org/2019-07-18-ttt-macquarie

Python google docs

https://denubis.github.io/python-novice-inflammation/ -> http://bit.ly/resbaz-python

SQL google docs

I already know I need to fix sql code and table detection. It was somewhat embarrassing to learn I missed that when running the workshop.
https://denubis.github.io/sql-novice-survey/ -> http://bit.ly/resbaz-sql

Pinging @fmichonneau and @maxim-belkin on this one. Let's get our specification written first, instead of in an endless iterating pull request.

@Denubis
Copy link
Author

Denubis commented Oct 8, 2019

Reading @brownsarahm's https://carpentries.org/blog/2018/09/teaching-tip-exercise-discussion/ -- is it worth exporting all code as code files to support load magic in lessons? (As an aside, do we want to use load magic as the basis for faded examples? With this infrastructure,and https://stackoverflow.com/a/16769695/263449 we can pack various exercises up into a zip file. Obviously this is not the place to discuss faded examples in workshops but this may be an opportunity to build infrastructure to use what we teach.

@lexnederbragt
Copy link

This is cool stuff! Auto-generating slides (e.g. Google Slides or markdown-based) with Questions, Objectives, Key Points and exercises would also be very helpful...

@beacurious
Copy link

beacurious commented Nov 18, 2019

When you did the instructor training that I was part of I noticed that you often (occasionally?) wanted to show an image that was in the notes (e.g. mind map examples, cartoons), but you didn't want to show the notes themselves (and they can't exist in the etherpad). I think you had a separate browser tab with them loaded (or a document, I can't remember). Is this something that could be helped with this tool?

@Denubis
Copy link
Author

Denubis commented Nov 18, 2019

Yes, that's why the tool exposes urls of images, so they can be opened in new tabs. In the google docs version, they're inline.

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

No branches or pull requests

3 participants