From 3e5174dab6764614a52d2971d82298ead7c7b017 Mon Sep 17 00:00:00 2001
From: PlexSheep <software@cscherr.de>
Date: Fri, 28 Jun 2024 14:50:13 +0200
Subject: [PATCH] docs(cli): expand on IsTerminal differences

---
 members/libpt-cli/src/printing.rs | 24 +++++++++++++++++++++++-
 1 file changed, 23 insertions(+), 1 deletion(-)

diff --git a/members/libpt-cli/src/printing.rs b/members/libpt-cli/src/printing.rs
index aed4fc7..e9d0c35 100644
--- a/members/libpt-cli/src/printing.rs
+++ b/members/libpt-cli/src/printing.rs
@@ -6,7 +6,29 @@
 //!
 //! Note that most of the utilities in this module are focused on communication with humans, not
 //! with machines. Consider evaluating [std::io::IsTerminal] before using colorful, dynamic and bordered
-//! printing.
+//! printing. If you are talking to a machine, it might be useful to not add extra space, add a
+//! newline per output or even output JSON. An example that does this well is `ls`:
+//!
+//! ```bash
+//! $ ls
+//! Cargo.lock  Cargo.toml  data  LICENSE  members  README.md  scripts  src  target
+//! ```
+//!
+//! ```bash
+//! $ ls | cat
+//! Cargo.lock
+//! Cargo.toml
+//! data
+//! LICENSE
+//! members
+//! README.md
+//! scripts
+//! src
+//! target
+//! ```
+//!
+//! See the [CLI Rustbook](https://rust-cli.github.io/book/in-depth/machine-communication.html) for
+//! more information on the topic.
 
 use comfy_table::presets;
 use comfy_table::{CellAlignment, ContentArrangement, Table};