diff --git a/terminal/terminal_other.go b/terminal/terminal_other.go
index <HASH>..<HASH> 100644
--- a/terminal/terminal_other.go
+++ b/terminal/terminal_other.go
@@ -7,8 +7,8 @@ import (
 	"os"
 )
 
-// getColorableWriter returns two values. First is Writer supported colors.
-// If return nil, colors will be disabled.
+// getColorableWriter simply returns stdout on
+// *nix machines.
 func getColorableWriter() io.Writer {
 	return os.Stdout
 }
diff --git a/terminal/terminal_windows.go b/terminal/terminal_windows.go
index <HASH>..<HASH> 100644
--- a/terminal/terminal_windows.go
+++ b/terminal/terminal_windows.go
@@ -9,8 +9,8 @@ import (
 	"github.com/mattn/go-colorable"
 )
 
-// getColorableWriter returns two values. First is Writer supported colors.
-// If return nil, colors will be disabled.
+// getColorableWriter will return a writer that is capable
+// of interpreting ANSI escape codes for terminal colors.
 func getColorableWriter() io.Writer {
 	if strings.ToLower(os.Getenv("ConEmuANSI")) == "on" {
 		// The ConEmu terminal is installed. Use it.
terminal: Update doc strings for getColorableWriter