hunk.code_window:               "description": "Localization options to use for the source locale",
                 "properties": {
                   "code": {
                     "type": "string",
                     "description": "Specifies the locale code of the source locale",
                     "pattern": "^[a-z]{2}(-[a-zA-Z]{2,})?$"
                   },
                   "baseHref": {
                     "type": "string",
                     "description": "HTML base HREF to use for the locale (defaults to the locale code)"
  
hunk.labels: keep keep keep keep keep replace keep keep keep keep
hunk.after_edit:                   "pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z]{4})?(-([a-zA-Z]{2}|[0-9]{3}))?(-[a-zA-Z]{5,8})?$"
  
hunk.file_path: packages/angular_devkit/core/src/experimental/workspace/workspace-schema.json
hunk.type: replace
file: ## Angular CLI
  
  <!-- Badges section here. -->
  [![Dependency Status][david-badge]][david-badge-url]
  [![devDependency Status][david-dev-badge]][david-dev-badge-url]
  
  [![npm](https://img.shields.io/npm/v/%40angular/cli.svg)][npm-badge-url]
  [![npm](https://img.shields.io/npm/v/%40angular/cli/next.svg)][npm-badge-url]
  [![npm](https://img.shields.io/npm/l/@angular/cli.svg)][license-url]
  [![npm](https://img.shields.io/npm/dm/@angular/cli.svg)][npm-badge-url]
  
  [![Join the chat at https://gitter.im/angular/angular-cli](https://img.shields.io/gitter/room/nwjs/nw.js.svg)](https://gitter.im/angular/angular-cli?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
  
  [![GitHub forks](https://img.shields.io/github/forks/angular/angular-cli.svg?style=social&label=Fork)](https://github.com/angular/angular-cli/fork)
  [![GitHub stars](https://img.shields.io/github/stars/angular/angular-cli.svg?style=social&label=Star)](https://github.com/angular/angular-cli)
  
  
  ## Note
  
  If you are updating from a beta or RC version, check out our [1.0 Update Guide](https://github.com/angular/angular-cli/wiki/stories-1.0-update).
  
  If you wish to collaborate, check out [our issue list](https://github.com/angular/angular-cli/issues).
  
  Before submitting new issues, have a look at [issues marked with the `type: faq` label](https://github.com/angular/angular-cli/issues?utf8=%E2%9C%93&q=is%3Aissue%20label%3A%22type%3A%20faq%22%20).
  
  ## Prerequisites
  
  Both the CLI and generated project have dependencies that require Node 8.9 or higher, together
  with NPM 5.5.1 or higher.
  
  ## Table of Contents
  
  * [Installation](#installation)
  * [Usage](#usage)
  * [Generating a New Project](#generating-and-serving-an-angular-project-via-a-development-server)
  * [Generating Components, Directives, Pipes and Services](#generating-components-directives-pipes-and-services)
  * [Updating Angular CLI](#updating-angular-cli)
  * [Development Hints for working on Angular CLI](#development-hints-for-working-on-angular-cli)
  * [Documentation](#documentation)
  * [License](#license)
  
  ## Installation
  
  **BEFORE YOU INSTALL:** please read the [prerequisites](#prerequisites)
  
  ### Install Globally
  ```bash
  npm install -g @angular/cli
  ```
  
  ### Install Locally
  ```bash
  npm install @angular/cli
  ```
  
  To run a locally installed version of the angular-cli, you can call `ng` commands directly by adding the `.bin` folder within your local `node_modules` folder to your PATH. The `node_modules` and `.bin` folders are created in the directory where `npm install @angular/cli` was run upon completion of the install command.
  
  Alternatively, you can install [npx](https://www.npmjs.com/package/npx) and run `npx ng <command>` within the local directory where `npm install @angular/cli` was run, which will use the locally installed angular-cli.
  
  ### Install Specific Version (Example: 6.1.1)
  ```bash
  npm install -g @angular/cli@6.1.1
  ```
  
  ## Usage
  
  ```bash
  ng help
  ```
  
  ### Generating and serving an Angular project via a development server
  
  ```bash
  ng new PROJECT-NAME
  cd PROJECT-NAME
  ng serve
  ```
  Navigate to `http://localhost:4200/`. The app will automatically reload if you change any of the source files.
  
  You can configure the default HTTP host and port used by the development server with two command-line options :
  
  ```bash
  ng serve --host 0.0.0.0 --port 4201
  ```
  
  ### Generating Components, Directives, Pipes and Services
  
  You can use the `ng generate` (or just `ng g`) command to generate Angular components:
  
  ```bash
  ng generate component my-new-component
  ng g component my-new-component # using the alias
  
  # components support relative path generation
  # if in the directory src/app/feature/ and you run
  ng g component new-cmp
  # your component will be generated in src/app/feature/new-cmp
  # but if you were to run
  ng g component ./newer-cmp
  # your component will be generated in src/app/newer-cmp
  # if in the directory src/app you can also run
  ng g component feature/new-cmp
  # and your component will be generated in src/app/feature/new-cmp
  ```
  You can find all possible blueprints in the table below:
  
  Scaffold  | Usage
  ---       | ---
  [Component](https://angular.io/cli/generate#component)      | `ng g component my-new-component`
  [Directive](https://angular.io/cli/generate#directive)      | `ng g directive my-new-directive`
  [Pipe](https://angular.io/cli/generate#pipe)                | `ng g pipe my-new-pipe`
  [Service](https://angular.io/cli/generate#service)          | `ng g service my-new-service`
  [Class](https://angular.io/cli/generate#class)              | `ng g class my-new-class`
  [Guard](https://angular.io/cli/generate#guard)              | `ng g guard my-new-guard`
  [Interface](https://angular.io/cli/generate#interface)      | `ng g interface my-new-interface`
  [Enum](https://angular.io/cli/generate#enum)                | `ng g enum my-new-enum`
  [Module](https://angular.io/cli/generate#module)            | `ng g module my-module`
  
  
  
  
  angular-cli will add reference to `components`, `directives` and `pipes` automatically in the `app.module.ts`. If you need to add this references to another custom module, follow these steps:
  
   1. `ng g module new-module` to create a new module
   2.  call `ng g component new-module/new-component`
  
  This should add the new `component`, `directive` or `pipe` reference to the `new-module` you've created.
  
  ### Updating Angular CLI
  
  If you're using Angular CLI `1.0.0-beta.28` or less, you need to uninstall `angular-cli` package. It should be done due to changing of package's name and scope from `angular-cli` to `@angular/cli`:
  ```bash
  npm uninstall -g angular-cli
  npm uninstall --save-dev angular-cli
  ```
  
  To update Angular CLI to a new version, you must update both the global package and your project's local package.
  
  Global package:
  ```bash
  npm uninstall -g @angular/cli
  npm cache verify
  # if npm version is < 5 then use `npm cache clean`
  npm install -g @angular/cli@latest
  ```
  
  Local project package:
  ```bash
  rm -rf node_modules dist # use rmdir /S/Q node_modules dist in Windows Command Prompt; use rm -r -fo node_modules,dist in Windows PowerShell
  npm install --save-dev @angular/cli@latest
  npm install
  ```
  
  If you are updating to 1.0 from a beta or RC version, check out our [1.0 Update Guide](https://github.com/angular/angular-cli/wiki/stories-1.0-update).
  
  You can find more details about changes between versions in [the Releases tab on GitHub](https://github.com/angular/angular-cli/releases).
  
  
  ## Development Hints for working on Angular CLI
  
  ### Working with master
  
  ```bash
  git clone https://github.com/angular/angular-cli.git
  yarn
  npm run build
  cd dist/@angular/cli
  npm link
  ```
  
  `npm link` is very similar to `npm install -g` except that instead of downloading the package
  from the repo, the just built `dist/@angular/cli/` folder becomes the global package.
  Additionally, this repository publishes several packages and we use special logic to load all of them
  on development setups.
  
  Any changes to the files in the `angular-cli/` folder will immediately affect the global `@angular/cli` package,
  meaning that, in order to quickly test any changes you make to the cli project, you should simply just run `npm run build`
  again.
  
  Now you can use `@angular/cli` via the command line:
  
  ```bash
  ng new foo
  cd foo
  npm link @angular/cli
  ng serve
  ```
  
  `npm link @angular/cli` is needed because by default the globally installed `@angular/cli` just loads
  the local `@angular/cli` from the project which was fetched remotely from npm.
  `npm link @angular/cli` symlinks the global `@angular/cli` package to the local `@angular/cli` package.
  Now the `angular-cli` you cloned before is in three places:
  The folder you cloned it into, npm's folder where it stores global packages and the Angular CLI project you just created.
  
  You can also use `ng new foo --link-cli` to automatically link the `@angular/cli` package.
  
  Please read the official [npm-link documentation](https://docs.npmjs.com/cli/link)
  and the [npm-link cheatsheet](http://browsenpm.org/help#linkinganynpmpackagelocally) for more information.
  
  To run the Angular CLI E2E test suite, use the `node ./tests/legacy-cli/run_e2e` command.
  It can also receive a filename to only run that test (e.g. `node ./tests/legacy-cli/run_e2e tests/legacy-cli/e2e/tests/build/dev-build.ts`).
  
  As part of the test procedure, all packages will be built and linked.
  You will need to re-run `npm link` to re-link the development Angular CLI environment after tests finish.
  
  ### Debugging with VS Code
  
  In order to debug some Angular CLI behaviour using Visual Studio Code, you can run `npm run build`, and then use a launch configuration like the following:
  
  ```json
  {
      "type": "node",
      "request": "launch",
      "name": "ng serve",
      "cwd": "<path to an Angular project generated with Angular-CLI>",
      "program": "${workspaceFolder}/dist/@angular/cli/bin/ng",
      "args": [
          "<ng command>",
          ...other arguments
      ],
      "console": "integratedTerminal"
  }
  ```
  
  Then you can add breakpoints in `dist/@angular` files.
  
  For more informations about Node.js debugging in VS Code, see the related [VS Code Documentation](https://code.visualstudio.com/docs/nodejs/nodejs-debugging).
  
  ### CPU Profiling
  
  In order to investigate performance issues, CPU profiling is often useful.
  
  To capture a CPU profiling, you can:
  1. install the v8-profiler-node8 dependency: `npm install v8-profiler-node8 --no-save`
  1. set the NG_CLI_PROFILING Environment variable to the file name you want:
      * on Unix systems (Linux & Mac OS X): ̀`export NG_CLI_PROFILING=my-profile`
      * on Windows: ̀̀`setx NG_CLI_PROFILING my-profile`
  
  Then, just run the ng command on which you want to capture a CPU profile.
  You will then obtain a `my-profile.cpuprofile` file in the folder from wich you ran the ng command.
  
  You can use the Chrome Devtools to process it. To do so:
  1. open `chrome://inspect/#devices` in Chrome
  1. click on "Open dedicated DevTools for Node"
  1. go to the "profiler" tab
  1. click on the "Load" button and select the generated .cpuprofile file
  1. on the left panel, select the associated file
  
  In addition to this one, another, more elaborated way to capture a CPU profile using the Chrome Devtools is detailed in https://github.com/angular/angular-cli/issues/8259#issue-269908550.
  
  ## Documentation
  
  The documentation for the Angular CLI is located in this repo's [wiki](https://angular.io/cli).
  
  ## License
  
  [MIT](https://github.com/angular/angular-cli/blob/master/LICENSE)
  
  
  [travis-badge]: https://travis-ci.org/angular/angular-cli.svg?branch=master
  [travis-badge-url]: https://travis-ci.org/angular/angular-cli
  [david-badge]: https://david-dm.org/angular/angular-cli.svg
  [david-badge-url]: https://david-dm.org/angular/angular-cli
  [david-dev-badge]: https://david-dm.org/angular/angular-cli/dev-status.svg
  [david-dev-badge-url]: https://david-dm.org/angular/angular-cli?type=dev
  [npm-badge]: https://img.shields.io/npm/v/@angular/cli.svg
  [npm-badge-url]: https://www.npmjs.com/package/@angular/cli
  [license-url]: https://github.com/angular/angular-cli/blob/master/LICENSE
  
  