link-all.sh (aws#20)

Allows symlinking the CDK repo into node_modules.

TODO: symlink binaries

* update README

README.md

@@ -74,6 +74,31 @@ cd packages/aws-cdk-s3
 lr watch
 ```
 
+## Linking against this repository
+
+The script `./link-all.sh` can be used to generate symlinks to all modules in
+this repository under some `node_module` directory. This can be used to develop
+against this repo as a local dependency.
+
+One can use the `postinstall` script to symlink this repo:
+
+```json
+{
+  "scripts": {
+    "postinstall": "../aws-cdk/link-all.sh"
+  }
+}
+```
+
+This assumes this repo is a sibling of the target repo and will install the CDK
+as a linked dependency during __npm install__.
+
+## Commits and Pull Requests
+
+Commits should follow the
+[conventional-changelog-standard](https://github.com/bcoe/conventional-changelog-standard/blob/master/convention.md)
+to allow automatic changelog generation.
+
 ## Package Linter
 
 The `pkglint` tool normalizes all packages in the repo. It verifies package.json

link-all.sh

@@ -0,0 +1,11 @@
+#!/bin/bash
+# creates symlinks under node_modules for all packages in this repo
+# can be used to work against this code base.
+set -euo pipefail
+root="$(cd $(dirname $0) && pwd)"
+
+modules="$(find ${root}/packages -name package.json | grep -v node_modules | grep -v init-templates | xargs -n1 dirname)"
+for module in ${modules}; do
+  echo "${module} => node_modules/$(basename ${module})"
+  ln -s ${module} node_modules/
+done