diff --git a/.env.example b/.env.example
index c990e3f5..1efc9be6 100644
--- a/.env.example
+++ b/.env.example
@@ -1,3 +1,3 @@
-# see http://www.ibm.com/watson/developercloud/doc/getting_started/gs-credentials.shtml
+# see https://www.ibm.com/watson/developercloud/doc/common/getting-started-credentials.html
 TONE_ANALYZER_USERNAME=<username>
 TONE_ANALYZER_PASSWORD=<password>
diff --git a/README.md b/README.md
index ab52295d..275bf915 100755
--- a/README.md
+++ b/README.md
@@ -109,7 +109,7 @@ This data is collected from the `VCAP_APPLICATION` environment variable in IBM B
 Deployment tracking can be disabled by removing `require('cf-deployment-tracker-client').track();` from the beginning of the `server.js` file at the root of this repo.
 
 [deploy_track_url]: https://github.com/cloudant-labs/deployment-tracker
-[docs]: http://www.ibm.com/smarterplanet/us/en/ibmwatson/developercloud/doc/tone-analyzer
+[docs]: http://www.ibm.com/watson/developercloud/doc/tone-analyzer
 [cloud_foundry]: https://github.com/cloudfoundry/cli
-[getting_started]: http://www.ibm.com/smarterplanet/us/en/ibmwatson/developercloud/doc/getting_started/
+[getting_started]: http://www.ibm.com/watson/developercloud/doc/common/index.html
 [sign_up]: https://console.ng.bluemix.net/registration/