From 2d437baf3bc4def49021605ea2661bf26c344fb5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C3=93lafur=20P=C3=A1ll=20Geirsson?= <olafurpg@gmail.com>
Date: Tue, 11 Sep 2018 11:15:16 +0200
Subject: [PATCH] Document reason for ignore-engines [CI SKIP]

---
 .travis.yml     | 2 ++
 CONTRIBUTING.md | 3 +++
 2 files changed, 5 insertions(+)

diff --git a/.travis.yml b/.travis.yml
index d41e56db..a58e0931 100644
--- a/.travis.yml
+++ b/.travis.yml
@@ -43,6 +43,8 @@ before_install:
   - nvm install "$TRAVIS_NODE_VERSION"
   - curl -o- -L https://yarnpkg.com/install.sh | bash -s -- --version "$TRAVIS_YARN_VERSION"
   - export PATH=$HOME/.yarn/bin:$PATH
+  # To avoid "engine node is incompatible with this version"
+  # See https://github.com/facebook/create-react-app/issues/4367#issuecomment-384667501
   - yarn config set ignore-engines true
 
 before_cache:
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index c15bd019..e5344ea4 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -28,7 +28,10 @@ git clone https://github.com/scalameta/metadoc.git
 cd metadoc
 git submodule init
 git submodule update
+
 npm install -g yarn
+yarn config set ignore-engines true # To avoid error: engine node is incompatible with this version
+
 sbt
   > metadoc-site                        # generate static site under target/metadoc.
   > js/fastOptJS::startWebpackDevServer # spin up local file server that listens for changes.