Writing conventions#
QuantEcon lectures are powered by Jupyter Book with the theme quantecon-book-theme
The following conventions should be adhered to for best results using quantecon-book-theme
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
Emphasis and definitions#
Use bold for definitions and italic for emphasis. For example,
A closed set is a set whose complement is open.
All consumers have identical endowments.
Titles and headings#
Capitalization of all words only for lecture titles.
Example: “How it Works: Data, Variables and Names”
Capitalization of only first word for all other headings (sections, subsections, etc.), capitalize proper nouns
Example: “Binary packages with Python frontends”