diff --git a/README.md b/README.md
index 15b39181a5..d427856826 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,8 @@ This package contains the Golang interface for using the Windows [Host Compute S
 
 It is primarily used in the [Moby Project](https://github.com/moby/moby), but it can be freely used by other projects as well.
 
+The tags in this repo are from a vendoring scheme intended the Docker repos, and is only stable for the v1 container and process API's. Newer projects vendoring this repo such as ContainerD or Kubernetes should use commit ids instead of tags, then validate fixes and do a test pass of the whole project. Hcsshim is not tested or released as an isolated unit.
+
 ## Contributing
 
 This project welcomes contributions and suggestions.  Most contributions require you to agree to a