summaryrefslogblamecommitdiffstats
path: root/2021/talks/teach.md
blob: 210735dd6a973735c624ebba8e0fb80adb114215 (plain) (tree)
1
2
3
4
5
6
7
8
9
10









                                                                                 

                                                                








                                                                      
                                                                                                 










                                                                                                    
            
 




                                                                                                                                                                   







                       

                                              
 

                                                                                   

 
                                                           
 
                                                           
[[!meta title="Using Org-mode to teach programming"]]
[[!meta copyright="Copyright © 2021 Daniel German"]]
[[!inline pages="internal(2021/info/teach-nav)" raw="yes"]]

<!-- You can manually edit this file to update the abstract, add links, etc. --->


# Using Org-mode to teach programming
Daniel German

[[!inline pages="internal(2021/info/teach-schedule)" raw="yes"]]

In this presentation I will explain how to use org-mode effectively to
prepare teaching materials, and how to present them.

For the last 5 years I have been using org-mode to teach programming
in different languages: C++, SQL, Ruby, Python, SML
and Scheme. Org-mode has three key advantages:

1.  it supports most programming languages with a common interface,
2.  it is an interactive medium for delivering teaching materials; and
3.  it is an always-up-to-date format that does not need to be exported in order to be published.

I explain how I use org-mode in my courses and how I combine org-mode
notes other tools such as github org-mode to get
always up-to-date teaching materials that one can use for both
teaching and studying (see
<https://github.com/dmgerman/csc116ModernCplusplus/blob/master/lectures/l-01-1-intro/01_1_intro.org>
for an example).

Finally, I will discuss some important aspects to consider when using
org-mode for this purpose.

# Discussion

- how do you keep the discipline of working on your notes? that's probably my biggest problem 
- I like "Try that with PowerPoint!" as a new org-babel slogan
- we just need krita and inkscape modes
- i remember doing similar in Smalltalk using a presentation tool with in it but with a full on graphical display of the Smalltalk environment not just text based.
- I liked the trick with annotating the code in xournal -- what is the elisp glue for that? Do you have a package for that?

# Outline

20 minutes:

-   Introduction
-   Quick demonstration
-   Workflow
-   Some Important considerations
-   Emacs configuration and how to get started

I have create a git repository with examples and config files that is ready to use:
<https://github.com/dmgerman/teachingProgOrg>


[[!inline pages="internal(2021/captions/teach)" raw="yes"]]

[[!inline pages="internal(2021/info/teach-nav)" raw="yes"]]