Skip to content
This repository was archived by the owner on Dec 4, 2017. It is now read-only.

Commit cec1f33

Browse files
committed
chore: tweak changelog and setup text
1 parent 281df32 commit cec1f33

File tree

3 files changed

+29
-16
lines changed

3 files changed

+29
-16
lines changed

public/docs/ts/latest/guide/change-log.jade

+17-9
Original file line numberDiff line numberDiff line change
@@ -5,16 +5,24 @@ block includes
55
The Angular documentation is a living document with continuous improvements.
66
This log calls attention to recent significant changes.
77

8-
## NEW: Added `src/` folder to all examples (2017-02-02)
9-
We've updated all our examples include a `src/` folder at the project root.
10-
Having this folder helps separate app code from setup and configuration files.
11-
You can read about moving your existing project to this structure in
12-
[the QuickStart repo update instructions](https://github.com/angular/quickstart#updating-to-a-newer-version-of-the-quickstart-repo).
13-
* `app/main.ts` has been moved to `src/main.ts`.
14-
* `app/` has been moved to `src/app/`.
15-
* `index.html`, `styles.css` and `tsconfig.json` have been moved inside `src/`.
8+
## NEW: Samples re-structured with `src/` folder (2017-02-02)
9+
All documentation samples have been realigned with the default folder structure of the angular-cli.
10+
That's a step along the road to basing our sample in the angular-cli.
11+
But it's also good in its own right.
12+
It helps clearly separate app code from setup and configuration files.
13+
14+
We've updated all samples with an `src/` folder at the project root.
15+
The former `app/` folder moves under `src/`.
16+
Read about moving your existing project to this structure in
17+
<a href="https://github.com/angular/quickstart#updating-to-a-newer-version-of-the-quickstart-repo" target="_blank" target="Migrating samples/quickstart app to the src folder">
18+
the QuickStart repo update instructions</a>.
19+
20+
Notably:
21+
* `app/main.ts` moved to `src/main.ts`.
22+
* `app/` moved to `src/app/`.
23+
* `index.html`, `styles.css` and `tsconfig.json` moved inside `src/`.
1624
* `systemjs.config.js` now imports `main.js` instead of `app`.
17-
* `lite-server` configuration (`bs-config.json`) to serve `src/`.
25+
* Added `lite-server` configuration (`bs-config.json`) to serve `src/`.
1826

1927
## NEW: Reactive Forms guide (2017-01-31)
2028
The new [**Reactive Forms**](reactive-forms.html) guide explains how and why to build a "reactive form".

public/docs/ts/latest/guide/setup-systemjs-anatomy.jade

+1-1
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ block includes
55
The documentation [setup](setup.html) procedures install a _lot_ of files,
66
Most of them can be safely ignored.
77

8-
Application files _inside the_ **`src/app/`** and **`e2e/`** folders matter most to developers.
8+
Application files _inside the_ **`src/`** and **`e2e/`** folders matter most to developers.
99

1010
Files _outside_ those folders condition the development environment.
1111
They rarely change and you may never view or modify them.

public/docs/ts/latest/guide/setup.jade

+11-6
Original file line numberDiff line numberDiff line change
@@ -129,12 +129,17 @@ block core-files
129129
`)(format='.')
130130

131131
:marked
132-
All guides and cookbooks have _at least these core files_. Each file has a distinct purpose and evolves independently as the application grows.
132+
All guides and cookbooks have _at least these core files_.
133+
Each file has a distinct purpose and evolves independently as the application grows.
133134

134-
Outside `src/` are files meant to support your app, like configuration files and external dependencies.
135+
Files outside `src/` concern building, deploying, and testing your app.
136+
They include configuration files and external dependencies.
135137

136-
Whenever a new Typescript, HTML or CSS file is created, it should go inside the `src/` directory (unless noted otherwise).
137-
This is the folder containing your app itself.
138+
Files inside `src/` "belong" to your app.
139+
Add new Typescript, HTML and CSS files inside the `src/` directory, most of them inside `src/app`,
140+
unless told to do otherwise.
141+
142+
The following are all in `src/`
138143

139144
style td, th {vertical-align: top}
140145
table(width="100%")
@@ -144,14 +149,14 @@ table(width="100%")
144149
th File
145150
th Purpose
146151
tr
147-
td <ngio-ex>app.component.ts</ngio-ex>
152+
td <ngio-ex>app/app.component.ts</ngio-ex>
148153
td
149154
:marked
150155
Defines the same `AppComponent` as the one in the QuickStart !{_playground}.
151156
It is the **root** component of what will become a tree of nested components
152157
as the application evolves.
153158
tr(if-docs="ts")
154-
td <code>app.module.ts</code>
159+
td <code>app/app.module.ts</code>
155160
td
156161
:marked
157162
Defines `AppModule`, the [root module](appmodule.html "AppModule: the root module") that tells Angular how to assemble the application.

0 commit comments

Comments
 (0)