Skip to content

Commit 2a4061a

Browse files
jbogarthydeatscott
authored andcommitted
docs: clarify status of sample app in stackblitz (angular#33574)
PR Close angular#33574
1 parent 41560b4 commit 2a4061a

File tree

2 files changed

+21
-19
lines changed

2 files changed

+21
-19
lines changed
18.6 KB
Loading

aio/content/start/index.md

Lines changed: 21 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -2,44 +2,38 @@
22

33
Welcome to Angular!
44

5-
This tutorial introduces you to the essentials of Angular by walking you through building a simple e-commerce site with a catalog, shopping cart, and check-out form. It uses the [StackBlitz](https://stackblitz.com/ "StackBlitz website") online development environment so you can get started right away.
6-
7-
8-
<div class="alert is-helpful">
9-
10-
This guide uses the StackBlitz Generator to show you a ready-made, simple application that you can examine and play with interactively. In actual development you will typically use the [Angular CLI](guide/glossary#command-line-interface-cli), a powerful command-line tool that lets you generate and modify applications. For more information, see the [CLI Overview](cli).
11-
12-
</div>
5+
This tutorial introduces you to the essentials of Angular by walking you through a simple e-commerce site with a catalog, shopping cart, and check-out form.
6+
To help you get started right away, this guide uses a simple ready-made application that you can examine and play with interactively.
137

148
<div class="callout is-helpful">
159
<header>New to web development?</header>
1610

1711

1812
There are many resources to complement the Angular docs. Mozilla's MDN docs include both [HTML](https://developer.mozilla.org/en-US/docs/Learn/HTML "Learning HTML: Guides and tutorials") and [JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript "JavaScript") introductions. [TypeScript's docs](https://www.typescriptlang.org/docs/home.html "TypeScript documentation") include a 5-minute tutorial. Various online course platforms, such as [Udemy](http://www.udemy.com "Udemy online courses") and [Codecademy](https://www.codecademy.com/ "Codecademy online courses"), also cover web development basics.
1913

20-
2114
</div>
2215

2316

24-
2517
{@a new-project}
2618
## Create a new project
2719

2820
<h4>
29-
<live-example name="getting-started-v0" noDownload>Click here to create a new project in StackBlitz.</live-example>
21+
<live-example name="getting-started-v0" noDownload>Click here to create the ready-made sample project in StackBlitz.</live-example>
3022
</h4>
3123

32-
StackBlitz creates a starter Angular app with a top
33-
bar&mdash;containing the store name and
34-
checkout icon&mdash;and the title for a product list.
35-
36-
3724
<figure class="lightbox">
3825
<div class="card">
39-
<img src="generated/images/guide/start/new-app.png" alt="Starter online store app">
26+
<img src="generated/images/guide/start/new-app-all.gif" alt="Starter online store app">
4027
</div>
4128
</figure>
4229

30+
* The preview pane on the right shows the starting state of the sample Angular app.
31+
It defines a frame with a top bar (containing the store name and checkout icon) and the title for a product list (which will be populated and dynamically updated with data from the application).
32+
33+
* The project pane on the left shows the source files that make up the application, including all of the infrastructure and configuration files. The currently selected file shows up in the editor pane in the middle.
34+
35+
Before going into the source structure, the next section shows how to fill out the HTML *template* for the product list, using the provided sample data.
36+
This should give you an idea how easy it is to modify and update the page dynamically.
4337

4438
<div class="callout is-helpful">
4539
<header>StackBlitz tips</header>
@@ -61,6 +55,15 @@ behavior will be the same.
6155

6256
</div>
6357

58+
<div class="alert is-helpful">
59+
60+
If you go directly to the [StackBlitz online development environment](https://stackblitz.com/) and choose to [start a new Angular workspace](https://stackblitz.com/fork/angular), you get a generic stub application, rather than this [illustrative sample](#new-project). Once you have been introduced to the basic concepts here, this can be helpful for working interactively while you are learning Angular.
61+
62+
In actual development you will typically use the [Angular CLI](guide/glossary#command-line-interface-cli), a powerful command-line tool that lets you generate and modify applications. For more information, see the [CLI Overview](cli).
63+
64+
</div>
65+
66+
6467
{@a template-syntax}
6568
## Template syntax
6669

@@ -73,8 +76,7 @@ To help you get going, the following steps use predefined product data and metho
7376

7477
</div>
7578

76-
1. In the `product-list` folder, open the template
77-
file `product-list.component.html`.
79+
1. In the `product-list` folder, open the template file `product-list.component.html`.
7880

7981
1. Modify the product list template to display a list of product names.
8082

0 commit comments

Comments
 (0)