From 2ffda5d5e455ecc652945c8d901b8670dca26910 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Dar=C3=ADo=20Javier=20Cravero?= <dario@uxtemple.com>
Date: Tue, 9 May 2017 19:28:04 +0100
Subject: [PATCH] docs: troubleshooting publishing issues

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index a81bed66c..2c01e4488 100644
--- a/README.md
+++ b/README.md
@@ -63,3 +63,19 @@ You can run `apm config get https-proxy` to verify it has been set correctly.
 ## Viewing configuration
 
 You can also run `apm config list` to see all the custom config settings.
+
+## Troubleshooting
+
+If publishing a version fails with an error message like:
+
+```
+Preparing and tagging a new version ✓
+Pushing v0.0.4 tag ✗
+error: src refspec v0.0.4 does not match any.
+error: failed to push some refs to 'git@github.com:repo/pkg.git'
+```
+
+You have `git-tag-version` disabled in your `~/.npmrc` config file.
+`apm` relies on `npm` tagging the GIT repos after versioning it.
+To fix this, either remove `git-tag-version=false` on `~/.npmrc` or make a new
+`.npmrc` file in your project's directory to override it with `git-tag-version=true`.