diff --git a/pages/linux/microcom.md b/pages/linux/microcom.md
index 2275a1b3e4..460cd69de0 100644
--- a/pages/linux/microcom.md
+++ b/pages/linux/microcom.md
@@ -1,11 +1,11 @@
 # microcom
 
-> A minimalistic terminal program.
+> A minimalistic terminal program, used to access remote devices via a serial, CAN or telnet connection from the console.
 
-- Open a serial port using the specified baudrate:
+- Open a serial port using the specified baud rate:
 
-`microcom --port {{path/to/serial-port}} --speed {{baudrate}}`
+`microcom --port {{path/to/serial_port}} --speed {{baud_rate}}`
 
-- Establish a telnet connection (rfc2217) to the specified host:
+- Establish a telnet connection to the specified host:
 
 `microcom --telnet {{hostname}}:{{port}}`