diff --git a/site/Docs/Reference/Known-Issues.markdown b/site/Docs/Reference/Known-Issues.markdown
index 3a19fd91..fabf02f7 100644
--- a/site/Docs/Reference/Known-Issues.markdown
+++ b/site/Docs/Reference/Known-Issues.markdown
@@ -205,3 +205,11 @@ Windows Phone Tools does not have support for the Visual Studio Extension Manage
 uninstall NuGet, run the following command.
 
      vsixinstaller.exe /uninstall:NuPackToolsVsix.Microsoft.67e54e40-0ae3-42c5-a949-fddf5739e7a5
+
+## Changing the capitalization of NuGet package IDs breaks package restore
+As discussed at length on [this GitHub issue](https://github.com/Particular/NServiceBus/issues/1271#issuecomment-20865932),
+changing the capitalization of NuGet packages can be done by NuGet support, but causes
+complications during package restore for users who have existing, differently-cased, packages
+in their local package cache. We recommend only requesting a case change when you have a way to
+communicate with existing users of your package about the break that may occur to their
+build-time package restore.