Merge branch 'develop' into byte

Author: bowbahdoe

book.toml

@@ -15,6 +15,8 @@ mathjax-support = true
 additional-css = ["ferris.css"]
 additional-js = ["ferris.js"]
 heading-split-level = 2
+default-theme = "light"
+preferred-default-theme = "light"
 
 [output.html.fold]
 enable = false # whether or not to enable section folding

src/SUMMARY.md

@@ -101,15 +101,54 @@ Intro to testing
 Gui stuff
 -->
 
-# Modern Java
 
 - [Prelude](./prelude.md)
   - [Asking for Help](./prelude/asking_for_help.md)
   - [Toy Problems](./prelude/toy_problems.md)
   - [Lies](./prelude/lies.md)
   - [AI](./prelude/ai.md)
   - [Java](./prelude/java.md)
-- [Getting Started](./getting_started.md)
+
+<!--
+# The Computing Environment
+
+- [Hardware](./hardware.md)
+  - [CPU](./hardware/cpu.md)
+  - [RAM](./hardware/ram.md)
+  - [Hard Drives](./hardware/hard_drives.md)
+  - [Motherboard](./hardware/motherboard.md)
+- [Operating Systems](./operating_systems.md)
+  - [Personal Computers](./operating_systems/personal_computers.md)
+  - [Servers](./operating_systems/servers.md)
+  - [Mobile Phones](./operating_systems/mobile_phones.md)
+  - [Game Consoles](./operating_systems/game_consoles.md)
+  - [Abstractions](./operating_systems/abstractions.md)
+  - [Defaults](./operating_systems/defaults.md)
+-->
+
+# Modern Java
+
+- [Set Up Your Computer](./text_editors/set_up_your_computer.md)
+  - [Text Editors](./text_editors.md)
+  - [IDEs](./text_editors/ides.md)
+  - [VSCodium](./text_editors/vscodium.md)
+  - [Install VSCodium](./text_editors/install_vscodium.md)
+  - [Install Java](./text_editors/install_java.md)
+- [The Terminal](./the_terminal.md)
+  - [Bash](./the_terminal/bash.md)
+  - [Windows Subsystem for Linux](./the_terminal/windows_subsystem_for_linux.md)
+  - [Chromebooks and School Computers](./the_terminal/chromebooks_and_school_computers.md)
+  - [Commands](./the_terminal/commands.md)
+  - [Directories](./the_terminal/directories.md)
+  - [Listing Files](./the_terminal/listing_files.md)
+  - [Creating Directories](./the_terminal/creating_directories.md)
+  - [Changing Directories](./the_terminal/changing_directories.md)
+  - [Creating Files](./the_terminal/creating_files.md)
+  - [Run Java Programs](./the_terminal/run_java_programs.md)
+  - [Getting Used to it](./the_terminal/getting_used_to_it.md)
+
+
+<!-- - [Getting Started](./getting_started.md) -->
 - [First Steps](./first_steps.md)
   - [Comments](./first_steps/comments.md)
   - [Semicolons](./first_steps/semicolon.md)
@@ -445,7 +484,7 @@ Gui stuff
 # Projects
 
 <!-- chicken nugget number type things come up when dispensing change -->
-- [Tic-Tac-Toe]()
+- [Tic-Tac-Toe](./projects/tic_tac_toe.md)
 
 
 # Concepts
@@ -458,35 +497,6 @@ Gui stuff
   - [Practice](./code_is_read_more_than_written/practice.md)
 
 
-
-# The Computing Environment
-
-- [Hardware](./hardware.md)
-  - [CPU](./hardware/cpu.md)
-  - [RAM](./hardware/ram.md)
-  - [Hard Drives](./hardware/hard_drives.md)
-  - [Motherboard](./hardware/motherboard.md)
-- [Operating Systems](./operating_systems.md)
-  - [Personal Computers](./operating_systems/personal_computers.md)
-  - [Servers](./operating_systems/servers.md)
-  - [Mobile Phones](./operating_systems/mobile_phones.md)
-  - [Game Consoles](./operating_systems/game_consoles.md)
-  - [Abstractions](./operating_systems/abstractions.md)
-  - [Defaults](./operating_systems/defaults.md)
-- [The Terminal](./the_terminal.md)
-  - [Bash](./the_terminal/bash.md)
-  - [Windows Subsystem for Linux](./the_terminal/windows_subsystem_for_linux.md)
-  - [Chromebooks and School Computers](./the_terminal/chromebooks_and_school_computers.md)
-  - [Commands](./the_terminal/commands.md)
-  - [Directories](./the_terminal/directories.md)
-  - [Listing Files](./the_terminal/listing_files.md)
-  - [Creating Directories](./the_terminal/creating_directories.md)
-  - [Changing Directories](./the_terminal/changing_directories.md)
-  - [Creating Files](./the_terminal/creating_files.md)
-  - [Run Java Programs](./the_terminal/run_java_programs.md)
-  - [Getting Used to it](./the_terminal/getting_used_to_it.md)
-
-
 # Control Flow IV
 
 - [Exceptions II](./exceptions_ii.md)
@@ -551,7 +561,7 @@ Gui stuff
   - [Optimized Implementation](./growable_arrays/optimized_implementation.md)
   - [Challenges](./growable_arrays/challenges.md)
 
-# Interactive Programs II
+# Interactive Programs III
 
 - [Command Line Arguments](./command_line_arguments.md)
   - [Accessing Arguments](./command_line_arguments/accessing_arguments.md)
@@ -613,7 +623,7 @@ Gui stuff
   - [Challenges](./integers_ii/challenges.md)
 
 
-# Interactive Programs III
+# Interactive Programs IV
 
 - [Files](./files.md)
   - [Paths](./files/paths.md)
@@ -874,10 +884,9 @@ Make them do one. -->
   - [Arguments](./lambdas/arguments.md)
   - [Return](./lambdas/return.md)
   - [Method References](./lambdas/method_references.md)
+  - [Constructor References](./lambdas/constructor_references.md)
   - [Inference](./lambdas/inference.md)
   - [Built-In Functional Interfaces](./lambdas/built_in_functional_interfaces.md)
-  - [Runnable](./lambdas/runnable.md)
-  - [Function](./lambdas/function.md)
   - [Checked Exceptions](./lambdas/checked_exceptions.md)
   - [Challenges](./lambdas/challenges.md)
 
@@ -953,7 +962,11 @@ TODO: Wait for hermetic java
   - [Collectors](./streams/collectors.md)
   - [Purpose](./streams/purpose.md)
   - [Challenges](./streams/challenges.md)
+
+
 <!--
+Make a challenge where the solution is to write normal code.
+
 - [Regular Expressions 🚧](./regular_expressions.md)
   - [Theoretical Basis](./regular_expressions/theoretical_basis.md)
   - [Pattern](./regular_expressions/pattern.md)
@@ -964,14 +977,26 @@ TODO: Wait for hermetic java
   - [Matcher]()
   - [Pathological Cases]()
   - [Power]()
+
+# Interactive Programs IV
+
+- [Files II](./files_ii.md)
+  - [List Files](./files_ii/list_files.md)
+  - [Read Lines](./files_ii/read_lines.md)
+  - [InputStream](./files_ii/input_stream.md)
+  - [OutputStream](./files_ii/output_stream.md)
+  - [Reader](./files_ii/reader.md)
+  - [Writer](./files_ii/writer.md)
   -->
 
+
 # Conclusion
 
 - [What Now?](./conclusion/what_now.md)
 
 
 <!-- 
+
 - [Strings III 🚧]()
 
 Streams II

src/compilation/modules.md

@@ -1,7 +1,7 @@
 # Modules
 
 For reasons that will become apparent as we proceed,
-it is best if all all the code you intend to share
+it is best if all the code you intend to share
 is contained within a named module.
 
 This means at minimum your classes would need to be in packages

src/compilation/running_compiled_code.md

@@ -18,8 +18,7 @@ you would run `java --class-path output chopin.Impromptu`.
 `--class-path` should be self-explanatory. It is the path where `java`
 will look for class files.
 
-But if you do not have any classes in the unnamed package - which will
-be hopefully be the case when you share code with others[^conflicts] -
+But if you do not have any classes in the unnamed package - which will hopefully be the case when you share code with others[^conflicts] -
 you instead want to run your code like this.
 
 ```

src/conclusion/what_now.md

@@ -142,12 +142,12 @@ most employable one of the many HTTP server options out there.
 ### Desktop Applications
 
 If you want to learn how to make desktop applications in Java you have basically
-three paths.
+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/24/docs/api/jdk.httpserver/module-summary.html)
+[Docs for `java.desktop` (Swing) here](https://docs.oracle.com/en/java/javase/24/docs/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
@@ -187,7 +187,8 @@ learned JavaScript that is a good one to touch next.
 
 There are languages out there like TypeScript that compile to JavaScript -
 and you can find some projects out there that do much the same for Java -
-but just practically speaking learning JavaScript
+but just practically speaking learning JavaScript is going to be something
+you have to do at some point if you get into making websites.
 
 ### C#
 
@@ -226,10 +227,10 @@ you do to make a full app in it, but it can't hurt.
 
 [Kotlin Android Tutorial here](https://kotlinlang.org/docs/android-overview.html)
 
-If you want to make Desktop or Mobile apps in Kotlin it is probably also worth checking out
-Jetpack Compose.
+If you want to make Desktop, Mobile, or Web apps in Kotlin it is probably also worth checking out
+Jetbrains Compose Multiplatfrom.
 
-[Getting Started for Jetpack Compose here](https://www.jetbrains.com/help/kotlin-multiplatform-dev/compose-multiplatform-create-first-app.html)
+[Getting Started for Jetbrains Compose Multiplatfrom here](https://www.jetbrains.com/help/kotlin-multiplatform-dev/compose-multiplatform-create-first-app.html)
 
 
 ### Others
@@ -261,4 +262,7 @@ context for quite yet:
 
 * Rust
 * Zig
+* Clojure
+
+
 [^wasm]: Fight me, WebAssembly fans.

src/easy_vs_simple.md

@@ -0,0 +1 @@
+# Easy vs. Simple

src/exceptions_ii/unchecked_exceptions.md

@@ -1,6 +1,6 @@
 # Unchecked Exceptions
 
-When a part of your code might throw a "unchecked" exception, other
+When a part of your code might throw an "unchecked" exception, other
 parts of your code do not need to account for that possibility.
 
 ```java

src/files_ii.md

@@ -0,0 +1 @@
+# Files II

src/files_ii/challenges.md

@@ -0,0 +1 @@
+# Challenges

src/files_ii/input_stream.md

@@ -0,0 +1 @@
+# InputStream