diff --git a/docs/concepts/BluetoothUWP.md b/docs/concepts/BluetoothUWP.md
index 1eb661a..9186f07 100644
--- a/docs/concepts/BluetoothUWP.md
+++ b/docs/concepts/BluetoothUWP.md
@@ -8,7 +8,7 @@ To use the NMEA Parser against a bluetooth device in a Windows Store or Windows
       </Device>
     </DeviceCapability>
 ```
-See more here on bluetooth device capabilities in WinStore: http://msdn.microsoft.com/en-us/library/windows/apps/dn263090.aspx
+See more here on bluetooth device capabilities in UWP Apps: https://docs.microsoft.com/en-us/uwp/schemas/appxpackage/how-to-specify-device-capabilities-for-bluetooth
 
 Make sure your Bluetooth device is paired with your Windows Device.
 
diff --git a/docs/concepts/BluetoothiOS.md b/docs/concepts/BluetoothiOS.md
index 5edcffd..3dc7ebb 100644
--- a/docs/concepts/BluetoothiOS.md
+++ b/docs/concepts/BluetoothiOS.md
@@ -1,3 +1,6 @@
 # Creating a Bluetooth device in an iOS app
 
 TODO...
+
+Help needed!
+Please see https://github.com/dotMorten/NmeaParser/issues/68
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
 }								
diff --git a/docs/concepts/SerialPortNetFX.md b/docs/concepts/SerialPortNetFX.md
index ca0e769..f71c493 100644
--- a/docs/concepts/SerialPortNetFX.md
+++ b/docs/concepts/SerialPortNetFX.md
@@ -1,12 +1,14 @@
 # Creating a Serial Port device in a .NET Framework
 
 ```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
 }