From 101a7921756d003f93986492dc569164b59769a6 Mon Sep 17 00:00:00 2001
From: Mitra Ardron <mitra@mitra.biz>
Date: Sun, 5 May 2019 11:55:50 +1000
Subject: [PATCH] yarn README.rst

---
 roles/yarn/README.rst | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)
 create mode 100644 roles/yarn/README.rst

diff --git a/roles/yarn/README.rst b/roles/yarn/README.rst
new file mode 100644
index 000000000..584b4fadb
--- /dev/null
+++ b/roles/yarn/README.rst
@@ -0,0 +1,21 @@
+.. |ss| raw:: html
+
+   <strike>
+
+.. |se| raw:: html
+
+   </strike>
+
+.. |nbsp| unicode:: 0xA0
+   :trim:
+
+==================
+yarn README
+==================
+
+Yarn is an alternative to npm that is becoming more widely used though there is still intense npm v. yarn debate.
+
+Its used for the internetarchive role partly because its faster and with MUCH less confusing error messages,
+partly because it does a better job of deduplicating nested modules - reducing disk and bandwidth usage
+but more importantly because the resulting node_modules is deterministic,
+so we can reach down and link to inner modules (dweb-archive and dweb-transports in particular) with certainty about where they will be.