I’ve had my fair share of confusion about this too (and I have a degree in engineering (not practicing), but I’m not an electrician). I too have a 2-way hallway switch that need to be made smart at some point. Care to share what you went with? The FB diagram? First or second one?