From 483f59d1102cd83a1547d59d997cf6571801e196 Mon Sep 17 00:00:00 2001
From: Ben Kochie <superq@gmail.com>
Date: Tue, 27 Feb 2018 19:46:01 +0100
Subject: [PATCH] Document use of atomic wrapper (#781)

Document how to use `sponge` to atomic update textfiles.
---
 text_collector_examples/README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/text_collector_examples/README.md b/text_collector_examples/README.md
index 540c3ddf..f47b37d3 100644
--- a/text_collector_examples/README.md
+++ b/text_collector_examples/README.md
@@ -3,5 +3,13 @@
 These scripts are examples to be used with the Node Exporter Textfile
 Collector.
 
+To use these scripts, we recommend using a `sponge` to atomically write the output.
+
+   <collector_script> | sponge <output_file>
+
+Sponge comes from [moreutils](https://joeyh.name/code/moreutils/)
+* [brew install moreutils](http://brewformulas.org/Moreutil)
+* [apt install moreutils](https://packages.debian.org/search?keywords=moreutils)
+
 For more information see:
 https://github.com/prometheus/node_exporter#textfile-collector