yes. the diodes are needed. if not, one leg of the switch is not connected to the matrix, so nothing will register.
the diodes are directional. think of them as a one way valve, electricity can only flow one direction. there is an anode and a cathode (see diagram below)
![[GB] ADK18 Numpad - Shipping now! Invoices out. 230619-0](https://geekhack.org/index.php?PHPSESSID=h8cd53p85hb2jdpifd23vdt2uu1pdq38&action=dlattach;topic=102453.0;attach=230619)
the stripe of the diode (the cathode) gets soldered to the square pad on the pcb. all of the ones that the labels begin with D underscore "D_" are where you put the diodes.
![[GB] ADK18 Numpad - Shipping now! Invoices out. 230620-1](https://geekhack.org/index.php?PHPSESSID=h8cd53p85hb2jdpifd23vdt2uu1pdq38&action=dlattach;topic=102453.0;attach=230621;image)
thanks kairuwu for the pics
it helps to pre bend the legs down to go through the holes
![[GB] ADK18 Numpad - Shipping now! Invoices out. 230622-2](https://geekhack.org/index.php?PHPSESSID=h8cd53p85hb2jdpifd23vdt2uu1pdq38&action=dlattach;topic=102453.0;attach=230623;image)
credit: keeb.io - iris pcb/diode shot
if you solder in your diodes before your switches, you'll be able to test the pcb before soldering the switches in.
you could actually test it without the diodes, but you'd need to short one of the switch pins to the square diode pin.