Improve comments

internal/multiplex/obfs.go

@@ -28,7 +28,7 @@ const (
 	E_METHOD_CHACHA20_POLY1305
 )
 
-// Obfuscator is responsible for the obfuscation and deobfuscation of frames
+// Obfuscator is responsible for serialisation, obfuscation, and optional encryption of data frames.
 type Obfuscator struct {
 	// Used in Stream.Write. Add multiplexing headers, encrypt and add TLS header
 	Obfs Obfser

internal/multiplex/session.go

@@ -50,8 +50,9 @@ type SessionConfig struct {
 	InactivityTimeout time.Duration
 }
 
-// A Session represents a self-contained communication chain between local and remote. It manages its streams and send
-// and receive data using the connection pool filled with connections added to the session.
+// A Session represents a self-contained communication chain between local and remote. It manages its streams,
+// controls serialisation and encryption of data sent and received using the supplied Obfuscator, and send and receive
+// data through a manged connection pool filled with underlying connections added to it.
 type Session struct {
 	id uint32