Home

How to write the lectures

A guide for RAs

General writing advice

Please keep it clear and keep it short.

One sentence paragraphs only.

Keep those one sentence paragraphs short and clear.

The value of the lecture is the importance and clarity of the information divided by the number of words.

Make sure the logical flow is good

• no jumps
• choose carefully what you pay attention to --- minimize distractions.

If you have a choice between two reasonable options, always pick the simplest one.

• don't capitalize unless you need to
• use $P$ instead of $\mathcal P$ when you have the option to choose freely

Make it pretty

Good lectures look good and use colors and layout to emphasize ideas.

Example: https://continuous-time-mcs.quantecon.org/kolmogorov_fwd.html

Make it simple

You are explaining ideas to undergraduates who know how to program.

Emphasize simulation and intuition over proofs.

Give references to harder material but help readers skip around it.

Workflow

Search for "NOTE" and "TODO".

Spell check and (if possible) grammar check.

References

The manual https://manual.quantecon.org/