Skip to content

Header cleanup + first CI (compile examples)#1

Merged
jonfroehlich merged 3 commits into
mainfrom
chore/footers-and-compile-ci
Jun 25, 2026
Merged

Header cleanup + first CI (compile examples)#1
jonfroehlich merged 3 commits into
mainfrom
chore/footers-and-compile-ci

Conversation

@jonfroehlich

Copy link
Copy Markdown
Member

First pass of v2.0 housekeeping for the library: fix a doc-comment compile bug, align the header footers with the lab's shared convention, and add the floor of CI so broken code can't land silently (this library is published on the Arduino registry).

Commits

  • Fix stray @ compile error in Button.hpp — inline /* */ block comments inside the /** */ Doxygen @code example prematurely closed the doc comment ("stray '@' in program"). Switched to // line comments inside @code.
  • Align .hpp header footers + add SPDX — replaced the retired @jonfroehlich / jonfroehlich.github.io lines (per docs/sketch-header-template.md in the arduino repo) with the shared footer used across the lab's repos, added SPDX-License-Identifier: MIT so the license travels with any single header a student copies out, kept the Doxygen @author tag, and preserved the specific OLED lesson links.
  • Add compile CIarduino/compile-sketches builds every sketch in examples/ on push/PR against arduino:avr:uno, installing this repo plus the Adafruit SSD1306 / GFX / BusIO dependencies.

Verification

  • All six examples compile clean locally on arduino:avr:uno.
  • /***/ doc blocks balanced across all 10 headers after the footer sweep.

Follow-ups (tracked in separate issues)

  • Off-device unit tests for the pure-logic classes (MovingAverageFilter, Shape collision, ColorName).
  • Extend the CI board matrix (e.g. ESP32) once confirmed compiling.

🤖 Generated with Claude Code

jonfroehlich and others added 3 commits June 25, 2026 11:18
Inline /* */ block comments inside the /** */ Doxygen @code example
prematurely closed the doc comment, turning the rest into stray code
("stray '@' in program"). Use // line comments inside @code instead.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Replace the retired "@jonfroehlich / jonfroehlich.github.io" footer
lines (per the canonical docs/sketch-header-template.md in the arduino
repo) with the shared footer used across the lab's repos, and add an
SPDX-License-Identifier so the MIT license travels with any single
header a student copies out. Keep the Doxygen @author tag, and preserve
the specific OLED lesson link as a "Learn more" line on the files that
had it.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
First CI for the library — the floor that mirrors the arduino repo's
setup. Uses arduino/compile-sketches to build every sketch in examples/
against Uno, installing this repo plus the Adafruit SSD1306 / GFX /
BusIO dependencies. Verified locally: all six examples compile clean.

Board list is a matrix so coverage (e.g. ESP32) can be added once
confirmed. Off-device unit tests for the pure-logic classes are a
planned follow-up.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@jonfroehlich jonfroehlich merged commit 22741be into main Jun 25, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant