diff --git a/node/README.md b/node/README.md
index f8c111169..36382cee4 100644
--- a/node/README.md
+++ b/node/README.md
@@ -15,7 +15,7 @@ Cross platform tasks are written in Typescript.  It is the preferred way to writ
 
 Step by Step: [Create Task](docs/stepbystep.md)  
 
-Documentation: [Typescript API](docs/vsts-task-lib.md)
+Documentation: [Typescript API](docs/vsts-task-lib.md), [task JSON schema](https://aka.ms/vsts-tasks.schema.json)
 
 Guidance: [Finding Files](docs/findingfiles.md), [Minimum agent version](docs/minagent.md), [Proxy](docs/proxy.md), [Certificate](docs/cert.md)
 
diff --git a/node/docs/stepbystep.md b/node/docs/stepbystep.md
index 64958044a..1d99b58f0 100644
--- a/node/docs/stepbystep.md
+++ b/node/docs/stepbystep.md
@@ -76,7 +76,7 @@ Change `tsconfig.json` file to ES6 to match the sample gist.  ES6 is for async a
 
 Now that the scaffolding is out of the way, let's create the task!
 
-Create a `task.json` file using `sample_task.json` as a starting point.    
+Create a `task.json` file using `sample_task.json` as a starting point. The full task JSON schema is [here](https://aka.ms/vsts-tasks.schema.json).
 
 Replace the `{{placeholders}}`.  The most important being a [unique guid](http://www.guidgen.com/).
 Note: copy from web view since file needs property names in quotes (browser might strip in raw view)