The goal of this education initiative is to curate and guide people’s learning experience, but not actually do much of the teaching ourselves.
There is so much good educational material out there on the internet that writing our own would mostly just add to the noise and waste time.
Cloin’s proposed structure is “rabbit-hole” articles that teach you the very basics of a subject top-down. For example: https://git.handmade.network/hmn/education-2022/src/branch/master/http_to_phy.md
These articles start at a very high level and drill down lower and lower. The goal is to write something that nearly anyone can gain information from, experienced or inexperienced. Each section recommends a list of learning resources, and contains extra information or exercises “below the fold” for those who want to know more.
We will carefully select topics for these pages so they can act as “hubs” for a broad area of knowledge.
Complementing the hubs are glossary terms that define a topic in brief and link out to another hub or other learning resources. The glossary helps people fill small gaps in their understanding as they read, but also is intended to have great SEO so more people find our educational content.
Intermediate programmers (and up). People who can write code, and have enough experience to pick up random programming topics, but don’t have domain-specific knowledge.
Content for total beginners is a non-goal.
We don’t need a ton of structure for this. All of this should act mostly like a wiki, but with carefully-chosen articles and complemented by a rich glossary.
Content will rely heavily on our existing Markdown infrastructure plus some custom extensions. Storing content versions is desirable, so we’ll probably make this another form of “post versions” (although perhaps we should rename to simply “content versions”).