Merge pull request #164 from bowbahdoe/develop

Update

Author: bowbahdoe

src/SUMMARY.md

@@ -389,6 +389,7 @@ Gui stuff
   - [Field Initialization](./classes/field_initialization.md)
   - [Field Access](./classes/field_access.md)
   - [Field Default Values](./classes/field_default_values.md)
+  - [Multiple Instances](./classes/multiple_instances.md)
   - [Aliasing](./classes/aliasing.md)
   - [Return Multiple Values](./classes/return_multiple_values.md)
   - [Challenges](./classes/challenges.md)

src/arrays/set_individual_elements.md

@@ -50,7 +50,7 @@ IO.println(
         + response[4]
 );
 
-response[2] = "is";
+response[index] = "is";
 IO.println(
     response[0] 
         + " " 

src/classes/multiple_instances.md

@@ -0,0 +1,26 @@
+# Multiple Instances
+
+If you make multiple instances of a class with `new`
+those classes will each have their own values for
+fields.
+
+```java
+class Muppet {
+    String name;
+}
+
+void main() {
+    Muppet kermit = new Muppet();
+    kermit.name = "Kermit The Frog";
+
+    Muppet animal = new Muppet();
+    animal.name = "animal";
+
+    // kermit and animal are distinct muppets
+    // and thus each have their own name.
+    IO.println(kermit.name);
+    IO.println(animal.name);
+}
+```
+
+Each instance has what we would call its own "identity."

src/conclusion/what_now.md

@@ -117,7 +117,7 @@ to in order to render websites.
 There are a lot of tools for this in Java. A lot a lot. I would recommend
 starting with the one that comes built-in: the `jdk.httpserver` module.
 
-[Docs for `jdk.httpserver` here](https://docs.oracle.com/en/java/javase/25/docs/api/jdk.httpserver/module-summary.html)
+[Docs for `jdk.httpserver` here](https://javadoc.mccue.dev/api/jdk.httpserver/module-summary.html)
 
 Then you will need to learn about SQL databases and how to query from/insert into them from Java.
 
@@ -147,7 +147,7 @@ two paths.
 Path #1 is to learn Java Swing. This is an old crusty GUI framework that is kinda difficult to use
 but has the pro of coming with Java and being able to run on every potato in existence.
 
-[Docs for `java.desktop` (Swing) here](https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/module-summary.html)
+[Docs for `java.desktop` (Swing) here](https://javadoc.mccue.dev/api/java.desktop/module-summary.html)
 
 Path #2 is the learn JavaFX. By all accounts JavaFX is better software than Swing, but it was cursed
 by coming out at a point in history where desktop apps were no longer big business to develop. It

src/documentation/challenges.md

@@ -19,6 +19,6 @@ Fix these by documenting that code enough that `javadoc` no longer gives you war
 
 ## Challenge 3.
 
-Read the [documentation for java.util.StringJoiner](https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/StringJoiner.html).
+Read the [documentation for java.util.StringJoiner](https://javadoc.mccue.dev/api/java.base/java/util/StringJoiner.html).
 
 If you can, alter one of your projects to use it.

src/documentation/javadoc.md

@@ -17,6 +17,6 @@ javadoc \
 This will produce a directory full of HTML files that contain all
 the documentation from the specified modules.
 
-This is what is used to make [the official Java documenation](https://docs.oracle.com/en/java/javase/25/docs/api/index.html) as well as at least part of the documentation for most Java libraries.
+This is what is used to make [the official Java documenation](https://javadoc.mccue.dev/api/index.html) as well as at least part of the documentation for most Java libraries.
 
 [^theme]: As is a theme with command-line tools

src/first_steps.md

@@ -62,3 +62,6 @@ You should get in the habit of, whenever you see some bit of code, trying to phy
 tweak it, and play with it.
 
 So try playing around with this program. If you actively engage then you will retain information better.
+
+A lot of the code samples in the book are runnable in your browser. Hover
+your mouse on the one above. You should see a run button in the top right.

src/hash_maps/challenges.md

@@ -90,7 +90,7 @@ class Main {
 ```
 
 If you feel like this is hard to do with just `.put` and `.get`, you can 
-check for [other methods on HashMap that can help you](https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/util/HashMap.html).
+check for [other methods on HashMap that can help you](https://javadoc.mccue.dev/api/java.base/java/util/HashMap.html).
 
 ## Challenge 3.
 

src/interfaces/cat_dog.mp4

@@ -50,3 +50,8 @@ void main() {
     barkAndFetch(new Cat());
 }
 ```
+
+<details>
+    <summary>Think a cat won't behave like a dog?</summary>
+    <video style="height: 600px" autoplay muted controls src="/interfaces/cat_dog.mp4"></video>
+</details>