Context
ScanDeck registers no .help command group. ScanDeckCommands.body registers only .newItem, a Batch menu, a Card menu and .sidebar.
So macOS supplies the stock "ScanDeck Help" item — and Resources/ScanDeck-Info.plist has no CFBundleHelpBookFolder or CFBundleHelpBookName key, so choosing it opens Help Viewer onto "Help isn't available for ScanDeck."
That is the first menu a confused operator opens, and it is currently a dead end on a project whose CONTRIBUTING.md is explicitly trying to be an on-ramp.
What to change
Add CommandGroup(replacing: .help) alongside the existing groups in Sources/ScanDeckApp/ScanDeckApp.swift, with items opening:
- the README on GitHub
SPEC.md — the contract, and the thing CONTRIBUTING asks people to poke holes in
- the issue tracker
Use NSWorkspace.shared.open(_:). Do not add a help book — that is a much larger commitment and the plist keys are deliberately absent.
While you are there: Settings already assembles a support report (DiagnosticsReport), and a "Copy Diagnostics Report" item in Help is the natural place to expose it. If you add it, route to the existing assembly — do not build a second one. DiagnosticsReport.Input has no field a path, file name or batch name could go in, and SettingsTests asserts none of them reach the text. That property is by construction and must stay that way.
How to verify
swift build
bash Scripts/bundle-app.sh --run # or --synthetic with no scanner
lsappinfo list | grep -A4 ScanDeck # expect type="Foreground"
swift test -c release
Open the Help menu; every item should go somewhere real.
See CONTRIBUTING.md. No scanner needed.
Context
ScanDeck registers no
.helpcommand group.ScanDeckCommands.bodyregisters only.newItem, a Batch menu, a Card menu and.sidebar.So macOS supplies the stock "ScanDeck Help" item — and
Resources/ScanDeck-Info.plisthas noCFBundleHelpBookFolderorCFBundleHelpBookNamekey, so choosing it opens Help Viewer onto "Help isn't available for ScanDeck."That is the first menu a confused operator opens, and it is currently a dead end on a project whose CONTRIBUTING.md is explicitly trying to be an on-ramp.
What to change
Add
CommandGroup(replacing: .help)alongside the existing groups inSources/ScanDeckApp/ScanDeckApp.swift, with items opening:SPEC.md— the contract, and the thing CONTRIBUTING asks people to poke holes inUse
NSWorkspace.shared.open(_:). Do not add a help book — that is a much larger commitment and the plist keys are deliberately absent.While you are there: Settings already assembles a support report (
DiagnosticsReport), and a "Copy Diagnostics Report" item in Help is the natural place to expose it. If you add it, route to the existing assembly — do not build a second one.DiagnosticsReport.Inputhas no field a path, file name or batch name could go in, andSettingsTestsasserts none of them reach the text. That property is by construction and must stay that way.How to verify
Open the Help menu; every item should go somewhere real.
See CONTRIBUTING.md. No scanner needed.