angular-cn/aio/tools/RELEASE.md

# Docs releases

This document explains how to update the documentation examples after an Angular release. This is only needed for major and minor versions.

All the packages for the docs' examples are specified in `/aio/tools/examples/shared/package.json`

**1)** So within the `shared` folder, you need to issue the following command:

```
$ yarn upgrade-interactive --tilde
```

There, select all the packages that are updated on the new Angular release.

**2)** Changes to the tsconfig.json? There is one to update at `/aio/tools/examples/shared/boilerplate/src/tsconfig.json`

**3)** The file `/aio/tools/examples/shared/boilerplate/src/systemjs.config.web.js` contains the configuration for plunkers. It has some hardcoded versions that could be updated. 

>N.B.: Plunkers have been replaced by Stackblitz and (almost) all examples have be replaced by CLI/WebPack-based examples that do not use SystemJS.
The upgrade examples may still rely on SystemJS.

**4)** As in step 3, more hardcoded versions at `/aio/tools/plunker-builder/translator/rules/indexHtml.js`

>Note the same caveat about migration from plunker to Stackblitz.
docs(aio): update examples to 4.3 2017-07-20 15:16:07 -04:00			`# Docs releases`

			`This document explains how to update the documentation examples after an Angular release. This is only needed for major and minor versions.`

			All the packages for the docs' examples are specified in `/aio/tools/examples/shared/package.json`

			1) So within the `shared` folder, you need to issue the following command:

			```
			`$ yarn upgrade-interactive --tilde`
			```

			`There, select all the packages that are updated on the new Angular release.`

			2) Changes to the tsconfig.json? There is one to update at `/aio/tools/examples/shared/boilerplate/src/tsconfig.json`

build(aio): migrate plunker to stackblitz (#20165) PR Close #20165 2017-11-03 13:08:28 -04:00			3) The file `/aio/tools/examples/shared/boilerplate/src/systemjs.config.web.js` contains the configuration for plunkers. It has some hardcoded versions that could be updated.

			`>N.B.: Plunkers have been replaced by Stackblitz and (almost) all examples have be replaced by CLI/WebPack-based examples that do not use SystemJS.`
			`The upgrade examples may still rely on SystemJS.`
docs(aio): update examples to 4.3 2017-07-20 15:16:07 -04:00
			4) As in step 3, more hardcoded versions at `/aio/tools/plunker-builder/translator/rules/indexHtml.js`
build(aio): migrate plunker to stackblitz (#20165) PR Close #20165 2017-11-03 13:08:28 -04:00
			`>Note the same caveat about migration from plunker to Stackblitz.`