diff --git a/Milestone.md b/Milestone.md
index f894319..19fc95d 100644
--- a/Milestone.md
+++ b/Milestone.md
@@ -3,13 +3,13 @@ Since vesion 1.1.0.x, Java 6 (1.6) or higher is required.
 ## snappy-java-1.1.3 (will be available Early 2017)
  * We are waiting contributions of native libraries for varios platforms.
    * Run `make native test` and send the result as a pull requset.
- * We also test the usability of the newly added bitshuffle API before this release.
+ * We also test the usability of the newly added BitShuffle API before this release.
 
 ## snappy-java-1.1.3-M1 (2017-01-19)
  * This is a preview release. Appreciate your feedback.
  * Upgraded to snappy 1.1.3 (Minor compression performance improvement)
  * Added support for armv5, armv6, armv7, android-arm, aarch64, ppc64
- * Added BitShuffle class for better float value compression
+ * Added BitShuffle (<https://github.com/kiyo-masui/bitshuffle>) class for better primitive array compression
  * Using docker-based cross compilers for building native libraries
  * AIX, FreeBSD, SunOS, IBM s390x are still using snappy 1.1.2. Your contirbutions of native libraries are welcome. Please send a pull request that contains the changes after runing `make native` in your platform.
 
diff --git a/README.md b/README.md
index 91e111f..bb6545a 100755
--- a/README.md
+++ b/README.md
@@ -9,7 +9,7 @@ snappy-java is a Java port of the snappy
   * JNI-based implementation to achieve comparable performance to the native C++ version.
      * Although snappy-java uses JNI, it can be used safely with multiple class loaders (e.g. Tomcat, etc.).
   * Compression/decompression of Java primitive arrays (`float[]`, `double[]`, `int[]`, `short[]`, `long[]`, etc.)
-     * To improve the compression ratios of these arrays, you can use a fast data-rearrangement implementation ([`BitShuffle`](https://github.com/kiyo-masui/bitshuffle)) before compression
+     * To improve the compression ratios of these arrays, you can use a fast data-rearrangement implementation ([`BitShuffle`](http://static.javadoc.io/org.xerial.snappy/snappy-java/1.1.3-M1/org/xerial/snappy/BitShuffle.html)) before compression
   * Portable across various operating systems; Snappy-java contains native libraries built for Window/Mac/Linux (64-bit). snappy-java loads one of these libraries according to your machine environment (It looks system properties, `os.name` and `os.arch`).
   * Simple usage. Add the snappy-java-(version).jar file to your classpath. Then call compression/decompression methods in `org.xerial.snappy.Snappy`.
   * [Framing-format support](https://github.com/google/snappy/blob/master/framing_format.txt) (Since 1.1.0 version)