aboutsummaryrefslogtreecommitdiff
path: root/puzzle
diff options
context:
space:
mode:
authorLoek Le Blansch <loek@pipeframe.xyz>2024-06-22 14:32:19 +0200
committerLoek Le Blansch <loek@pipeframe.xyz>2024-06-22 14:32:19 +0200
commit33d17dbab86c1277a1327273fb9753b2c98b7b03 (patch)
treee868c781953faeb5227787d130d208b93ff49147 /puzzle
parent5113ffd3b0b3c761681456fae5ed554c2b35cc8d (diff)
more documentation
Diffstat (limited to 'puzzle')
-rw-r--r--puzzle/dummy/index.dox9
-rw-r--r--puzzle/neo/index.dox6
-rw-r--r--puzzle/readme.md17
-rw-r--r--puzzle/vault/index.dox6
4 files changed, 32 insertions, 6 deletions
diff --git a/puzzle/dummy/index.dox b/puzzle/dummy/index.dox
new file mode 100644
index 0000000..918bf7f
--- /dev/null
+++ b/puzzle/dummy/index.dox
@@ -0,0 +1,9 @@
+// vim:ft=doxygen
+/**
+\ingroup puz
+\defgroup puz_dummy Dummy
+\brief Demo puzzle module
+
+The dummy puzzle module consists of an empty Arduino sketch, and can be used as
+a starting point for developing new puzzle modules.
+*/
diff --git a/puzzle/neo/index.dox b/puzzle/neo/index.dox
new file mode 100644
index 0000000..14cefdc
--- /dev/null
+++ b/puzzle/neo/index.dox
@@ -0,0 +1,6 @@
+// vim:ft=doxygen
+/**
+\ingroup puz
+\defgroup puz_neo Neo
+\brief NeoTrellis puzzle module
+*/
diff --git a/puzzle/readme.md b/puzzle/readme.md
index 59c10b1..959c506 100644
--- a/puzzle/readme.md
+++ b/puzzle/readme.md
@@ -1,15 +1,20 @@
+\defgroup puz puzzle
+\brief Puzzle modules
+
# puzzles
This folder contains the source code for all puzzle modules.
## Arduino-based puzzle modules
-Because of the poorly designed hardware (21-22) used during development
-(23-24), some puzzle modules ended up being developed using Arduino boards. All
-libraries in this repository use CMake for building (for consistency), which
-also means the Arduino based puzzle modules use CMake. The CMakeLists.txt of
-some puzzles uses the [Arduino-CMake-Toolchain][arduino-cmake]. To build any of
-these subfolders, make sure you have done the following:
+> [!NOTE]
+> Because of the poorly designed hardware (21-22) used during development
+> (23-24), all puzzle modules ended up being developed using Arduino boards.
+
+All libraries in this repository use CMake for building (for consistency),
+which also means the Arduino based puzzle modules use CMake. The CMakeLists.txt
+of some puzzles uses the [Arduino-CMake-Toolchain][arduino-cmake]. To build any
+of these subfolders, make sure you have done the following:
- Install the official Arduino IDE
- Open "Tools" > "Board" > "Board manager"
diff --git a/puzzle/vault/index.dox b/puzzle/vault/index.dox
new file mode 100644
index 0000000..b14e616
--- /dev/null
+++ b/puzzle/vault/index.dox
@@ -0,0 +1,6 @@
+// vim:ft=doxygen
+/**
+\ingroup puz
+\defgroup puz_vault Vault
+\brief Vault puzzle module
+*/