2016-05-18 16:43:02 -04:00
block includes
include ../_util-fns
2016-11-23 12:58:21 -05:00
- var _angular_io = 'angular.io';
2015-08-08 16:55:53 -04:00
2016-11-21 20:13:21 -05:00
- var __lang = _docsFor || current.path[1] || 'ts';
- var guideData = public.docs[__lang].latest.guide._data;
- var advancedLandingPage = '';
- for(var page in guideData) {
- if (!guideData[page].basics && !guideData[page].hide) { advancedLandingPage = page; break; }
- }
- var advancedUrl = './' + advancedLandingPage + '.html'
2016-11-14 07:29:17 -05:00
2015-11-28 23:43:09 -05:00
:marked
2016-11-21 20:13:21 -05:00
This page describes the Angular documentation at a high level.
If you're new to Angular, you may want to visit "[Learning Angular](learning-angular.html)" first.
2016-02-25 12:03:50 -05:00
2016-11-21 20:13:21 -05:00
## Themes
2016-05-18 16:43:02 -04:00
2016-02-06 02:27:06 -05:00
The documentation is divided into major thematic sections, each
2016-08-29 11:37:39 -04:00
a collection of pages devoted to that theme.
2016-09-24 17:30:06 -04:00
block js-alert
2016-02-06 02:27:06 -05:00
- var top="vertical-align:top"
table(width="100%")
col(width="15%")
col
2016-05-18 16:43:02 -04:00
tr(style=top)
2016-11-18 17:55:21 -05:00
td <b><a href="../quickstart.html">QuickStart</a></b>
2016-05-18 16:43:02 -04:00
td
:marked
2016-11-23 12:58:21 -05:00
A first taste of Angular<span if-docs="ts"> with zero installation.
Run "Hello World" in an online code editor and start playing with live code</span>.
2016-02-06 02:27:06 -05:00
tr(style=top)
2016-11-21 20:13:21 -05:00
td <b>Guide</b>
2016-02-06 02:27:06 -05:00
td
:marked
2016-11-21 20:13:21 -05:00
Learn the Angular basics (you're already here!) like the setup for local development,
displaying data and accepting user input, injecting application services into components,
and building simple forms.
2016-02-06 02:27:06 -05:00
tr(style=top)
2016-11-21 20:13:21 -05:00
td <b><a href="../api/">API Reference</a></b>
2016-02-06 02:27:06 -05:00
td
:marked
2016-11-21 20:13:21 -05:00
Authoritative details about each of the Angular libraries.
2016-02-06 02:27:06 -05:00
tr(style=top)
2016-11-21 20:13:21 -05:00
td <b><a href="../tutorial/">Tutorial</a></b>
2016-02-06 02:27:06 -05:00
td
:marked
2016-09-20 00:23:02 -04:00
A step-by-step, immersive approach to learning Angular that
introduces the major features of Angular in an application context.
2016-02-06 02:27:06 -05:00
tr(style=top)
2016-11-17 19:53:28 -05:00
td <b><a href="!{advancedUrl}">Advanced</a></b>
2016-02-06 02:27:06 -05:00
td
:marked
2016-09-20 00:23:02 -04:00
In-depth analysis of Angular features and development practices.
2016-11-30 13:31:06 -05:00
tr(style=top if-docs="ts")
2016-11-21 20:13:21 -05:00
td <b><a href="../cookbook/">Cookbook</a></b>
2016-02-06 02:27:06 -05:00
td
:marked
2016-09-20 00:23:02 -04:00
Recipes for specific application challenges, mostly code snippets with a minimum of exposition.
2016-11-17 19:53:28 -05:00
2016-02-25 12:03:50 -05:00
:marked
2016-11-21 20:13:21 -05:00
A few early pages are written as tutorials and are clearly marked as such.
The rest of the pages highlight key points in code rather than explain each step necessary to build the sample.
You can always get the full source through the #{_liveLink}s.
2016-09-24 17:30:06 -04:00
2016-11-16 13:02:31 -05:00
## Code samples
2016-05-18 16:43:02 -04:00
2016-11-21 20:13:21 -05:00
Each page includes code snippets from a sample application that accompanies the page.
You can reuse these snippets in your applications.
2016-05-18 16:43:02 -04:00
2016-11-21 20:13:21 -05:00
Look for a link to a running version of that sample, often near the top of the page,
2016-11-17 19:53:28 -05:00
such as this <live-example name="architecture"></live-example> from the [Architecture](architecture.html) page.
2016-11-23 12:58:21 -05:00
<span if-docs="ts">
2016-11-21 20:13:21 -05:00
The link launches a browser-based, code editor where you can inspect, modify, save, and download the code.
2016-11-23 12:58:21 -05:00
</span>
2016-05-18 16:43:02 -04:00
2016-11-21 20:29:00 -05:00
## Reference pages
2016-11-21 20:13:21 -05:00
2016-11-21 20:13:21 -05:00
* The [Cheat Sheet](cheatsheet.html) lists Angular syntax for common scenarios.
* The [Glossary](glossary.html) defines terms that Angular developers should know.
2016-11-23 12:58:21 -05:00
<li if-docs="ts">The [Change Log](change-log.html) announces what's new and changed in the documentation.</li>
2016-11-21 20:13:21 -05:00
* The [API Reference](../api/) is the authority on every public-facing member of the Angular libraries.
## Feedback
2016-05-18 16:43:02 -04:00
2016-11-21 20:13:21 -05:00
We welcome feedback!
2016-05-18 16:43:02 -04:00
2016-11-23 12:58:21 -05:00
* Use the <a href="!{_ngDocRepoURL}" target="_blank" title="angular docs on github">!{_angular_io} Github repository</a> for **documentation** issues and pull requests.
2016-11-21 20:13:21 -05:00
* Use the <a href="!{_ngRepoURL}" target="_blank" title="angular source on github">Angular Github repository</a> to report issues with **Angular** itself.