diff --git a/docs/concepts/SerialPortNetCore.md b/docs/concepts/SerialPortNetCore.md
index b1c0e0c..05e7b72 100644
--- a/docs/concepts/SerialPortNetCore.md
+++ b/docs/concepts/SerialPortNetCore.md
@@ -1,12 +1,14 @@
 # Creating a Serial Port device in a .NET Core app
 
 ```csharp
-var port = new System.IO.Ports.SerialPort("COM3", 9600); //change name and baud rage to match your serial port
+string portname = "COM3"; // Change to match the name of the port your device is connected to
+int baudrate = 9600; // Change to the baud rate your device communicates at (usually specified in the manual)
+var port = new System.IO.Ports.SerialPort(portname, baudrate);
 var device = new NmeaParser.SerialPortDevice(port);
-device.MessageReceived += device_NmeaMessageReceived;
+device.MessageReceived += OnNmeaMessageReceived;
 device.OpenAsync();
 ...
-private void device_NmeaMessageReceived(NmeaParser.NmeaDevice sender, NmeaParser.NmeaMessageReceivedEventArgs args)
+private void OnNmeaMessageReceived(NmeaParser.NmeaDevice sender, NmeaParser.NmeaMessageReceivedEventArgs args)
 {
    // called when a message is received
 }