jsonnet-libs · Duologic · Sep 29, 2022 · Sep 29, 2022 · malcolmholmes · Sep 29, 2022
diff --git a/_gen/index.md b/_gen/index.md
@@ -30,11 +30,11 @@ For package management we'll use jsonnet-bundler, please
 > don't know how Kubernetes works, this isn't a requirement for understanding the Jsonnet
 > examples.
 
-1. [Write an extensible library](lesson1.md)
-1. [Understanding Package management](lesson2.md)
-1. [Exercise: rewrite a library with `k8s-libsonnet`](lesson3.md)
-1. [Further developing libraries](lesson4.md)
-1. [Providing documentation with Docsonnet](lesson5.md)
+1. [Introduction exercise](lesson1.md)
-1. [Introduction exercise](lesson1.md)
+1. [Introductory exercise](lesson1.md)
-1. [Introduction exercise](lesson1.md)
+1. [Introductory exercise](lesson1.md)
+1. [Package management](lesson2.md)
+1. [Refactoring exercise](lesson3.md)
+1. [Wrapping libraries](lesson4.md)
+1. [Documentation](lesson5.md)
 1. [Unit testing](lesson6.md)
 
 
diff --git a/_gen/lesson1.md b/_gen/lesson1.md
@@ -1,8 +1,8 @@
-# Write an extensible library
+# Introduction exercise
-# Introduction exercise
+# Introductory exercise
-# Introduction exercise
+# Introductory exercise
 
 Jsonnet gives us a lot of freedom to organize our libraries, there is no right or
 wrong, however a well-organized library can get you a long way. While applying common
-software development best-practices, we'll come up with an extensible library to
+software development best-practices, we'll come up with an *extensible library* to
 deploy a webserver on Kubernetes.
 
 

diff --git a/_gen/lesson2.md b/_gen/lesson2.md
@@ -1,4 +1,4 @@
-# Understanding Package management
+# Package management
 
 There are a ton of Jsonnet libraries out there, ranging from big generated libraries
 to manually curated for a very specific purpose. Let's have a look at how to find and

diff --git a/_gen/lesson3.md b/_gen/lesson3.md
@@ -1,4 +1,4 @@
-# Exercise: rewrite a library with `k8s-libsonnet`
+# Refactoring exercise
 
 In the first lesson we've written a extensible library and in the second lesson we've
 covered package management with jsonnet-bundler. In this lesson we'll combine what

diff --git a/_gen/lesson4.md b/_gen/lesson4.md
@@ -1,4 +1,4 @@
-# Further developing libraries
+# Wrapping libraries
 
 When starting out with Jsonnet, it is very likely that you'll with existing code and
 dependencies. Developing on these can seem confusing and tedious, however there are

diff --git a/_gen/lesson5.md b/_gen/lesson5.md
@@ -1,4 +1,4 @@
-# Providing documentation with Docsonnet
+# Documentation
-# Documentation
+# Documenting Code
-# Documentation
+# Documenting Code
 
 [Docsonnet](https://github.com/jsonnet-libs/docsonnet) provides a way to consistently
 add docstrings to Jsonnet code. As Docsonnet docstrings are written as Jsonnet

diff --git a/docs/index.html b/docs/index.html
@@ -40,11 +40,11 @@ <h2>Lessons</h2>
 examples.</p>
 </blockquote>
 <ol>
-<li><a href="lesson1.html">Write an extensible library</a></li>
-<li><a href="lesson2.html">Understanding Package management</a></li>
-<li><a href="lesson3.html">Exercise: rewrite a library with <code>k8s-libsonnet</code></a></li>
-<li><a href="lesson4.html">Further developing libraries</a></li>
-<li><a href="lesson5.html">Providing documentation with Docsonnet</a></li>
+<li><a href="lesson1.html">Introduction exercise</a></li>
+<li><a href="lesson2.html">Package management</a></li>
+<li><a href="lesson3.html">Refactoring exercise</a></li>
+<li><a href="lesson4.html">Wrapping libraries</a></li>
+<li><a href="lesson5.html">Documentation</a></li>
 <li><a href="lesson6.html">Unit testing</a></li>
 </ol>
 </main>

diff --git a/docs/lesson1.html b/docs/lesson1.html
@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html>
 <head>
-<title>Write an extensible library - Jsonnet Training Course</title>
+<title>Introduction exercise - Jsonnet Training Course</title>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <meta name="generator" content="md2html">
@@ -15,10 +15,10 @@
 
 <main>
 <p><span class="nav index"><a href="index.html">index</a></span> <span class="nav next"><a href="lesson2.html">next »</a></span></p>
-<h1>Write an extensible library</h1>
+<h1>Introduction exercise</h1>
 <p>Jsonnet gives us a lot of freedom to organize our libraries, there is no right or
 wrong, however a well-organized library can get you a long way. While applying common
-software development best-practices, we'll come up with an extensible library to
+software development best-practices, we'll come up with an <em>extensible library</em> to
 deploy a webserver on Kubernetes.</p>
 <h2>Objectives</h2>
 <ul>

diff --git a/docs/lesson2.html b/docs/lesson2.html
@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html>
 <head>
-<title>Understanding Package management - Jsonnet Training Course</title>
+<title>Package management - Jsonnet Training Course</title>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <meta name="generator" content="md2html">
@@ -15,7 +15,7 @@
 
 <main>
 <p><span class="nav previous"><a href="lesson1.html">« previous</a></span> <span class="nav index"><a href="index.html">index</a></span> <span class="nav next"><a href="lesson3.html">next »</a></span></p>
-<h1>Understanding Package management</h1>
+<h1>Package management</h1>
 <p>There are a ton of Jsonnet libraries out there, ranging from big generated libraries
 to manually curated for a very specific purpose. Let's have a look at how to find and
 vendor them.</p>

diff --git a/docs/lesson3.html b/docs/lesson3.html
@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html>
 <head>
-<title>Exercise: rewrite a library with `k8s-libsonnet` - Jsonnet Training Course</title>
+<title>Refactoring exercise - Jsonnet Training Course</title>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <meta name="generator" content="md2html">
@@ -15,7 +15,7 @@
 
 <main>
 <p><span class="nav previous"><a href="lesson2.html">« previous</a></span> <span class="nav index"><a href="index.html">index</a></span> <span class="nav next"><a href="lesson4.html">next »</a></span></p>
-<h1>Exercise: rewrite a library with <code>k8s-libsonnet</code></h1>
+<h1>Refactoring exercise</h1>
 <p>In the first lesson we've written a extensible library and in the second lesson we've
 covered package management with jsonnet-bundler. In this lesson we'll combine what
 we've learned and rewrite that library.</p>

diff --git a/docs/lesson4.html b/docs/lesson4.html
@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html>
 <head>
-<title>Further developing libraries - Jsonnet Training Course</title>
+<title>Wrapping libraries - Jsonnet Training Course</title>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <meta name="generator" content="md2html">
@@ -15,7 +15,7 @@
 
 <main>
 <p><span class="nav previous"><a href="lesson3.html">« previous</a></span> <span class="nav index"><a href="index.html">index</a></span> <span class="nav next"><a href="lesson5.html">next »</a></span></p>
-<h1>Further developing libraries</h1>
+<h1>Wrapping libraries</h1>
 <p>When starting out with Jsonnet, it is very likely that you'll with existing code and
 dependencies. Developing on these can seem confusing and tedious, however there are
 several techniques that can help us iterate at different velocities.</p>

diff --git a/docs/lesson5.html b/docs/lesson5.html
@@ -1,7 +1,7 @@
 <!DOCTYPE html>
 <html>
 <head>
-<title>Providing documentation with Docsonnet - Jsonnet Training Course</title>
+<title>Documentation - Jsonnet Training Course</title>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <meta name="generator" content="md2html">
@@ -15,7 +15,7 @@
 
 <main>
 <p><span class="nav previous"><a href="lesson4.html">« previous</a></span> <span class="nav index"><a href="index.html">index</a></span> <span class="nav next"><a href="lesson6.html">next »</a></span></p>
-<h1>Providing documentation with Docsonnet</h1>
+<h1>Documentation</h1>
 <p><a href="https://github.com/jsonnet-libs/docsonnet">Docsonnet</a> provides a way to consistently
 add docstrings to Jsonnet code. As Docsonnet docstrings are written as Jsonnet
 attributes, it can also natively render user-friendly documentation in Markdown.</p>

diff --git a/lessons/lesson1/main.jsonnet b/lessons/lesson1/main.jsonnet
@@ -5,11 +5,11 @@ local examples = import './examples.jsonnet';
 
 lesson.new(
   'lesson1',
-  'Write an extensible library',
+  'Introduction exercise',
   |||
     Jsonnet gives us a lot of freedom to organize our libraries, there is no right or
     wrong, however a well-organized library can get you a long way. While applying common
-    software development best-practices, we'll come up with an extensible library to
+    software development best-practices, we'll come up with an *extensible library* to
     deploy a webserver on Kubernetes.
   |||,
   [

diff --git a/lessons/lesson2/main.jsonnet b/lessons/lesson2/main.jsonnet
@@ -5,7 +5,7 @@ local examples = import './examples.jsonnet';
 
 lesson.new(
   'lesson2',
-  'Understanding Package management',
+  'Package management',
   |||
     There are a ton of Jsonnet libraries out there, ranging from big generated libraries
     to manually curated for a very specific purpose. Let's have a look at how to find and

diff --git a/lessons/lesson3/main.jsonnet b/lessons/lesson3/main.jsonnet
@@ -5,7 +5,7 @@ local examples = import './examples.jsonnet';
 
 lesson.new(
   'lesson3',
-  'Exercise: rewrite a library with `k8s-libsonnet`',
+  'Refactoring exercise',
   |||
     In the first lesson we've written a extensible library and in the second lesson we've
     covered package management with jsonnet-bundler. In this lesson we'll combine what

diff --git a/lessons/lesson4/main.jsonnet b/lessons/lesson4/main.jsonnet
@@ -5,7 +5,7 @@ local examples = import './examples.jsonnet';
 
 lesson.new(
   'lesson4',
-  'Further developing libraries',
+  'Wrapping libraries',
   |||
     When starting out with Jsonnet, it is very likely that you'll with existing code and
     dependencies. Developing on these can seem confusing and tedious, however there are

diff --git a/lessons/lesson5/main.jsonnet b/lessons/lesson5/main.jsonnet
@@ -10,7 +10,7 @@ local examples =
 
 lesson.new(
   'lesson5',
-  'Providing documentation with Docsonnet',
+  'Documentation',
   |||
     [Docsonnet](https://github.com/jsonnet-libs/docsonnet) provides a way to consistently
     add docstrings to Jsonnet code. As Docsonnet docstrings are written as Jsonnet