Programming Historian English Language Lesson Template
This file can be used as a template for writing your lesson. It includes information and guidelines on formatting which supplement but do not replace the author’s guidelines (https://programminghistorian.org/en/author-guidelines)
Some Important Reminders:
Tutorials should not exceed 8,000 words (including code).
Keep your tone formal but accessible.
Talk to your reader in the second person (you).
Adopt a widely-used version of English (British, Canadian, Indian, South African etc).
The piece of writing is a “tutorial” or a “lesson” and not an “article”.
Adopt open source principles
Write for a global audience
Delete everything above this line when ready to submit your lesson.
title: YOUR TITLE HERE
slug: LEAVE BLANK
date: LEAVE BLANK
translation_date: LEAVE BLANK
bold textitalic textreserved words (eg “for loop”, or “myData.csv”)
Create a link to Programming Historian using the format in this sentence. Ensure linked phrases are semantically meaningful. Do not link terms that are meaningful only to sighted users such as “click here”.
Copy this short-code to insert an image. Replace words in all caps with your image information (eg, Figure1.jpg). Captions should include sequential image numbering (eg “Figure 1: …”).
Alerts and Warnings
If you want to include an aside or a warning to readers, you can set it apart from the main text:
Be sure that you follow directions carefully!
It will appear in a coloured box and can be useful for drawing attention to particular warnings.