Merge pull request #446 from Chia-Network/academy-go-live

Academy go live
Chia-Network · Dec 12, 2023 · 2d3b0a5 · 2d3b0a5
2 parents 46468cf + c57f1b3
commit 2d3b0a5
Show file tree

Hide file tree

Showing 17 changed files with 149 additions and 31 deletions.
diff --git a/docs/academy/blockchain-basics/block-formation-basics.md b/docs/academy/blockchain-basics/block-formation-basics.md
@@ -2,6 +2,7 @@
 title: How New Blocks are Formed
 slug: /block-formation-basics
 ---
+In this lesson, we review the basics of block formation including the farmers role in validating transactions, forming blocks, and managing the mempool.
 
 ## Learning objectives
 - **Transaction Validation**: Learn how nodes validate transactions for inclusion in a block.
@@ -11,10 +12,9 @@ slug: /block-formation-basics
 ---
 
 ## Content
-In this lesson, we review the basics of block formation including the farmers role in validating transactions, forming blocks, and managing the mempool.
 
 <div class="videoWrapper">
-<iframe width="100%" height="504" src="https://www.youtube.com/embed/5XAbF_gs07I" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
+<iframe width="100%" height="504" src="https://www.youtube.com/embed/yxt53B4GGbM" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
 </div>
 
 ---

diff --git a/docs/academy/blockchain-basics/coinset-basics.md b/docs/academy/blockchain-basics/coinset-basics.md
@@ -2,6 +2,7 @@
 title: Coin-Set Model Intro
 slug: /coinset-basics
 ---
+In this lesson, we dive into the coinset model basics and learn what it means to spend a coin in Chia.
 
 ## Learning objectives
 - **Coin Contents**: Learn what data is stored in a coin.
@@ -11,10 +12,9 @@ slug: /coinset-basics
 ---
 
 ## Content
-In this lesson, we dive into the coinset model basics and learn what it means to spend a coin in Chia.
 
 <div class="videoWrapper">
-<iframe width="100%" height="504" src="https://www.youtube.com/embed/-axXmWEor-Q" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
+<iframe width="100%" height="504" src="https://www.youtube.com/embed/QMs6Z6_ZQdg" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
 </div>
 
 ---

diff --git a/docs/academy/blockchain-basics/consensus-basics.md b/docs/academy/blockchain-basics/consensus-basics.md
@@ -2,6 +2,7 @@
 title: How Chia Consensus Works
 slug: /consensus-basics
 ---
+In this lesson, we review the basics of consensus, the process by which to determine the true state of a blockchain.
 
 ## Learning objectives
 - **Farmers**: Understand the basic role of farmers in providing proofs of space.
@@ -11,10 +12,9 @@ slug: /consensus-basics
 ---
 
 ## Content
-In this lesson, we review the basics of consensus, the process by which to determine the true state of a blockchain.
 
 <div class="videoWrapper">
-<iframe width="100%" height="504" src="https://www.youtube.com/embed/JJnGAwsJjXQ" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
+<iframe width="100%" height="504" src="https://www.youtube.com/embed/6fbZwfrYkcg" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
 </div>
 
 ---

diff --git a/docs/academy/blockchain-basics/security-basics.md b/docs/academy/blockchain-basics/security-basics.md
@@ -2,6 +2,7 @@
 title: Chia Blockchain Security Intro
 slug: /security-basics
 ---
+In this lesson, we learn the basic security implementations in Chia and how they protect users from bad actors.
 
 ## Learning objectives
 - **Decentralization**: Understand how a decentralized network enhances security and reduces attack options for bad actors.
@@ -11,10 +12,9 @@ slug: /security-basics
 ---
 
 ## Content
-In this lesson, we learn the basic security implementations in Chia and how they protect users from bad actors.
 
 <div class="videoWrapper">
-<iframe width="100%" height="504" src="https://www.youtube.com/embed/mwnSMDikkWg" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
+<iframe width="100%" height="504" src="https://www.youtube.com/embed/CATI6OVHPAg" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
 </div>
 
 ---

diff --git a/docs/academy/blockchain-basics/timelord-basics.md b/docs/academy/blockchain-basics/timelord-basics.md
@@ -2,6 +2,7 @@
 title: What are Timelords
 slug: /timelord-basics
 ---
+In this lesson, we dive into the role that Timelords play in the consensus by using VDFs to generate challenges.
 
 ## Learning objectives
 - **Proofs of Time**: Learn how Proofs of Time are created by timelords and what role they perform.
@@ -11,10 +12,9 @@ slug: /timelord-basics
 ---
 
 ## Content
-In this lesson, we dive into the role that Timelords play in the consensus by using VDFs to generate challenges.
 
 <div class="videoWrapper">
-<iframe width="100%" height="504" src="https://www.youtube.com/embed/zFQskQASUFM" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
+<iframe width="100%" height="504" src="https://www.youtube.com/embed/tJPdBmpgvsc" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
 </div>
 
 ---

diff --git a/docs/academy/chialisp/chialisp-inner-puzzle.md b/docs/academy/chialisp/chialisp-inner-puzzle.md
@@ -3,6 +3,10 @@ title: Inner Puzzles
 slug: /chialisp-inner-puzzle
 ---
 
+import Runnable from '../../../src/components/Runnable.tsx';
+
+In this lesson, we'll talk about why you might want to nest puzzles and how to set them up.
+
 ## Learning objectives
 
 - **Functions**: Learn how to define and execute functions in Chialisp.
@@ -12,7 +16,6 @@ slug: /chialisp-inner-puzzle
 
 ## Content
 
-In this lesson, we'll talk about why you might want to nest puzzles and how to set them up.
 
 <div class="videoWrapper">
 <iframe width="100%" height="504" src="https://www.youtube.com/embed/GAw1yMmkO3g" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
@@ -119,6 +122,32 @@ What does the `ASSERT_HEIGHT_RELATIVE` condition check for?
 
 ## Additional resources
 
+### Runnable Chialisp and clvm plugins
+
+For information on using these plugins please refer to the [academy overview](/academy-overview#runnable-chialisp-and-clvm-plugins)
+
+#### Chialisp plugin
+
+<Runnable flavor='chialisp' input='(10 99)'>
+
+```chialisp
+(mod (arg1 arg2)
+    (if (> (+ arg1 arg2) 100) "large" "small")
+)
+```
+
+</Runnable>
+
+#### Clvm plugin
+
+<Runnable flavor='clvm' input='(1)'>
+
+```chialisp
+(a (i 2 (q 1 . "true") (q 1 . "false")) 1)
+```
+
+</Runnable>
+
 ### Links
 
 - General [chialisp concepts](https://docs.chia.net/guides/chialisp-concepts): overviews of currying, inner puzzles, and morphing conditions.

diff --git a/docs/academy/chialisp/chialisp-intro.md b/docs/academy/chialisp/chialisp-intro.md
@@ -5,6 +5,8 @@ slug: /chialisp-intro
 
 import Runnable from '../../../src/components/Runnable.tsx';
 
+In this lesson, we review the basics of Chialisp including syntax & structure, inequalities and if statements, and setting up a development environment.
+
 ## Learning objectives
 
 - **Syntax and Structure**: Understand the basic Chialisp syntax and structure.
@@ -15,8 +17,6 @@ import Runnable from '../../../src/components/Runnable.tsx';
 
 ## Content
 
-In this lesson, we review the basics of Chialisp including syntax & structure, inequalities and if statements, and setting up a development environment.
-
 <div class="videoWrapper">
 <iframe width="100%" height="504" src="https://www.youtube.com/embed/W9QK4PFIIpA" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
 </div>

diff --git a/docs/academy/chialisp/chialisp-signatures.md b/docs/academy/chialisp/chialisp-signatures.md
@@ -3,6 +3,10 @@ title: Signatures
 slug: /chialisp-signatures
 ---
 
+import Runnable from '../../../src/components/Runnable.tsx';
+
+In this lesson, we go over how to secure coins using signatures.
+
 ## Learning objectives
 
 - **Signing and Signatures**: Understand the uses and benefits of signatures.
@@ -12,8 +16,6 @@ slug: /chialisp-signatures
 
 ## Content
 
-In this lesson, we go over how to secure coins using signatures.
-
 <div class="videoWrapper">
 <iframe width="100%" height="504" src="https://www.youtube.com/embed/zD1rhLKgc9Y" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
 </div>
@@ -138,6 +140,32 @@ The `AGG_SIG_ME` condition expects a concatenated value of the following:
 
 ## Additional resources
 
+### Runnable Chialisp and clvm plugins
+
+For information on using these plugins please refer to the [academy overview](/academy-overview#runnable-chialisp-and-clvm-plugins)
+
+#### Chialisp plugin
+
+<Runnable flavor='chialisp' input='(10 99)'>
+
+```chialisp
+(mod (arg1 arg2)
+    (if (> (+ arg1 arg2) 100) "large" "small")
+)
+```
+
+</Runnable>
+
+#### Clvm plugin
+
+<Runnable flavor='clvm' input='(1)'>
+
+```chialisp
+(a (i 2 (q 1 . "true") (q 1 . "false")) 1)
+```
+
+</Runnable>
+
 ### Links
 
 - General [chialisp concepts](https://docs.chia.net/guides/chialisp-concepts): overviews of currying, inner puzzles, and morphing conditions.

diff --git a/docs/academy/chialisp/chialisp-smart-coin.md b/docs/academy/chialisp/chialisp-smart-coin.md
@@ -3,6 +3,10 @@ title: Smart Coins
 slug: /chialisp-smart-coin
 ---
 
+import Runnable from '../../../src/components/Runnable.tsx';
+
+In this lesson, we go over currying, hashing, and conditions, and submit and use our first Chia Smart Coin.
+
 ## Learning objectives
 
 - **Currying**: Understand how to create more general use puzzle by using Currying.
@@ -13,8 +17,6 @@ slug: /chialisp-smart-coin
 
 ## Content
 
-In this lesson, we go over currying, hashing, and conditions, and submit and use our first Chia Smart Coin.
-
 <div class="videoWrapper">
 <iframe width="100%" height="504" src="https://www.youtube.com/embed/-Nza_N9Xb3Y" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
 </div>
@@ -191,6 +193,32 @@ Write a Chialisp puzzle that performs the following.
 
 ## Additional resources
 
+### Runnable Chialisp and clvm plugins
+
+For information on using these plugins please refer to the [academy overview](/academy-overview#runnable-chialisp-and-clvm-plugins)
+
+#### Chialisp plugin
+
+<Runnable flavor='chialisp' input='(10 99)'>
+
+```chialisp
+(mod (arg1 arg2)
+    (if (> (+ arg1 arg2) 100) "large" "small")
+)
+```
+
+</Runnable>
+
+#### Clvm plugin
+
+<Runnable flavor='clvm' input='(1)'>
+
+```chialisp
+(a (i 2 (q 1 . "true") (q 1 . "false")) 1)
+```
+
+</Runnable>
+
 ### Links
 
 - General [chialisp concepts](https://docs.chia.net/guides/chialisp-concepts): overviews of currying, inner puzzles, and morphing conditions.

diff --git a/docs/academy/plotting-farming/challenges-plot-filters.md b/docs/academy/plotting-farming/challenges-plot-filters.md
@@ -3,6 +3,8 @@ title: Challenges & Plot Filters
 slug: /challenges-plot-filters
 ---
 
+In this lesson, we discuss how the plot filter works, and what the benefits are of using one.
+
 ## Learning objectives
 
 - **Plot Filters**: Understand the basics of how the plot filter works, as well as the benefits of using one.
@@ -12,10 +14,8 @@ slug: /challenges-plot-filters
 
 ## Content
 
-In this lesson, we discuss how the plot filter works, and what the benefits are of using one.
-
 <div class="videoWrapper">
-<iframe width="100%" height="504" src="https://www.youtube.com/embed/N55a0xQANVg" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
+<iframe width="100%" height="504" src="https://www.youtube.com/embed/7L17dRNI6Kc" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
 </div>
 
 ---

diff --git a/docs/academy/plotting-farming/farming-overview.md b/docs/academy/plotting-farming/farming-overview.md
@@ -3,6 +3,8 @@ title: Farming Overview
 slug: /farming-overview
 ---
 
+In this lesson, we go over the plotting process, and what happens when a Farmer wins a challenge.
+
 ## Learning objectives
 
 - **Protocols**: Understand the basics of the Chia Farming protocol.
@@ -12,10 +14,8 @@ slug: /farming-overview
 
 ## Content
 
-In this lesson, we go over the plotting process, and what happens when a Farmer wins a challenge.
-
 <div class="videoWrapper">
-<iframe width="100%" height="504" src="https://www.youtube.com/embed/Y1BFnOkZAps" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
+<iframe width="100%" height="504" src="https://www.youtube.com/embed/vyn0nIO56WU" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
 </div>
 
 ---

diff --git a/docs/academy/plotting-farming/first-plot.md b/docs/academy/plotting-farming/first-plot.md
@@ -3,6 +3,8 @@ title: Creating your first Plot
 slug: /first-plot
 ---
 
+In this lesson, we learn how to set up the Chia client, sync our full node using a torrent file, and create our first plot to start farming.
+
 ## Learning objectives
 
 - **Syncing a Full Node**: Learn how to set up the Chia client and sync a full node.
@@ -12,10 +14,8 @@ slug: /first-plot
 
 ## Content
 
-In this lesson, we learn how to set up the Chia client, sync our full node using a torrent file, and create our first plot to start farming.
-
 <div class="videoWrapper">
-<iframe width="100%" height="504" src="https://www.youtube.com/embed/UgTe1t-bMsU" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
+<iframe width="100%" height="504" src="https://www.youtube.com/embed/W9v7A8UJk9Q" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
 </div>
 
 ---

diff --git a/docs/academy/plotting-farming/pools.md b/docs/academy/plotting-farming/pools.md
@@ -3,6 +3,8 @@ title: Pools
 slug: /pools
 ---
 
+In this lesson, we review the Pooling protocol, and how it can benefit a Farmer starting out.
+
 ## Learning objectives
 
 - **Benefits of Pooling**: Understand the benefits of participating in a Pool.
@@ -12,10 +14,8 @@ slug: /pools
 
 ## Content
 
-In this lesson, we review the Pooling protocol, and how it can benefit a Farmer starting out.
-
 <div class="videoWrapper">
-<iframe width="100%" height="504" src="https://www.youtube.com/embed/UgTe1t-bMsU" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
+<iframe width="100%" height="504" src="https://www.youtube.com/embed/qO1ctn7DhwE" frameborder="0" allowfullscreen="allowfullscreen"></iframe>
 </div>
 
 ---

diff --git a/docusaurus.config.js b/docusaurus.config.js
@@ -59,6 +59,12 @@ const katex = require('rehype-katex');
               position: 'left',
               label: 'Guides',
             },
+            {
+              type: 'doc',
+              docId: 'academy/academy-intro/academy-overview',
+              position: 'left',
+              label: 'Chia Academy',
+            },
             {
               href: 'https://chialisp.com',
               label: 'Chialisp',
@@ -108,6 +114,10 @@ const katex = require('rehype-katex');
                   label: 'Chialisp',
                   to: 'https://chialisp.com',
                 },
+                {
+                  label: 'Chia Academy',
+                  to: 'https://docs.chia.net/academy-overview/',
+                },
               ],
             },
             {