@@ -6,15 +6,36 @@ template = "sections/docs/hoon.html"
66aliases = ["/docs/byte/0/", "/docs/byte", "/docs/learn/hoon/hoon-tutorial/"]
77+++
88
9−This series is designed to teach you Hoon without assuming you have an extensive programming background. In fact, you should be able to follow much of it even if you have no programming experience at all, though of course experience helps. We strongly encourage you to try out all the examples of each lesson. These lessons are meant for the beginner but they aren't meant to be skimmed. Each lesson falls into one of two categories: **readings**, which are prose-heavy explanations of Hoon fundamentals, and **walkthroughs**, which are line-by-line explanations of example programs. Walkthroughs are found between readings, offering a practical implementation of the concepts taught in the reading before.
9+This series is designed to teach you Hoon without assuming you have an extensive
10+programming background. In fact, you should be able to follow much of it even if
11+you have no programming experience at all, though of course experience helps. We
12+strongly encourage you to try out all the examples of each lesson. These lessons
13+are meant for the beginner, but they aren't meant to be skimmed. Each lesson
14+falls into one of two categories: **readings**, which are prose-heavy
15+explanations of Hoon fundamentals, and **walkthroughs**, which are line-by-line
16+explanations of example programs. Walkthroughs are found between readings,
17+offering a practical implementation of the concepts taught in the reading
18+before.
1019
11−Before you start, we recommend reading [Why Hoon?](https://urbit.org/blog/why-hoon/), a blog post by a Tlon engineer that justifies the existence and use of this peculiar language. This explainer gives useful context to all types of learners, but those new to programming will need to use Google frequently for the jargon.
20+If you're curious about why Urbit is written in this new language, we recommend
21+reading the [Hoon overview](@/docs/hoon/overview.md) that covers the high-level
22+design decisions behind the language.
1223
13−Chapter 1 introduces and explains the fundamental concepts you need in order to understand Hoon's semantics.
24+Chapter 1 introduces and explains the fundamental concepts you need in order to
25+understand Hoon's semantics.
1426
15−Hoon is a "subject-oriented" programming language -- every expression of Hoon is evaluated relative to a **subject**. The subject is a piece of data that represents the environment, or the context, of an expression. After reading Chapter 1 you should understand what the subject is and how to refer to its various parts. In this chapter you'll also learn about **[cores](/docs/glossary/core/)**, which are an important data structure in Hoon. Once you get the hang of [cores](/docs/glossary/core/) you'll be able to write your own functions in Hoon.
27+Hoon is a "subject-oriented" programming language — every expression of
28+Hoon is evaluated relative to a **subject**. The subject is a piece of data that
29+represents the environment, or the context, of an expression. After reading
30+Chapter 1 you should understand what the subject is and how to refer to its
31+various parts. In this chapter you'll also learn about
32+**[cores](/docs/glossary/core/)**, which are an important data structure in
33+Hoon. Once you get the hang of [cores](/docs/glossary/core/) you'll be able to
34+write your own functions in Hoon.
1635
17−Chapter 2 covers the type system, and writing apps, and the workings of the Arvo kernel.
36+Chapter 2 covers the type system, writing basic apps, and the workings of the
37+Arvo kernel.
1838
19−You should also consider enrolling in Hooniversity, a regularly held community-run
20−course which follows along the Hoon School curriculum and may be found at [Hooniversity](https://hooniversity.org/).
39+You should also consider enrolling in Hooniversity, a regularly held
40+community-run course which follows along the Hoon School curriculum and may be
41+found at [Hooniversity](https://hooniversity.org/).