Skip to content
This repository was archived by the owner on Apr 12, 2024. It is now read-only.

Commit 20051e5

Browse files
docs(guide): tweaks to the index and external resources guides
Closes #14843
1 parent 708e3d9 commit 20051e5

File tree

3 files changed

+48
-34
lines changed

3 files changed

+48
-34
lines changed

docs/content/api/index.ngdoc

+1-1
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Welcome to the AngularJS API docs page. These pages contain the AngularJS refere
88
The documentation is organized into **{@link guide/module modules}** which contain various components of an AngularJS application.
99
These components are {@link guide/directive directives}, {@link guide/services services}, {@link guide/filter filters}, {@link guide/providers providers}, {@link guide/templates templates}, global APIs, and testing mocks.
1010

11-
There is also a {@link guide/index} with articles on various topics, and a list of external resources.
11+
There is also a {@link guide/index guide} with articles on various topics, and a list of external resources.
1212

1313
<div class="alert alert-info">
1414
**Angular Prefixes `$` and `$$`**:

docs/content/guide/external.ngdoc renamed to docs/content/guide/external-resources.ngdoc

+12-11
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,10 @@
11
@ngdoc overview
22
@name External Resources
3-
@sortOrder 560
3+
@sortOrder 205
44
@description
55

6+
# External Angular 1 Resources
7+
68
This is a collection of external, 3rd party resources for learning and developing Angular.
79

810
## Articles, Videos, and Projects
@@ -19,15 +21,14 @@ This is a collection of external, 3rd party resources for learning and developin
1921

2022
#### Application Structure & Style Guides
2123

24+
* [Angular Styleguide](https://github.com/johnpapa/angular-styleguide/blob/master/a1/README.md)
2225
* [Architecture, file structure, components, one-way dataflow and best practices](https://github.com/toddmotto/angular-styleguide)
23-
* [Angular Styleguide](https://github.com/johnpapa/angular-styleguide)
2426
* [When to use directives, controllers or services](http://kirkbushell.me/when-to-use-directives-controllers-or-services-in-angular/)
2527
* [Service vs Factory](http://blog.thoughtram.io/angular/2015/07/07/service-vs-factory-once-and-for-all.html)
2628

2729
#### Testing
2830

29-
* **Unit testing:** [Karma](http://karma-runner.github.io), [Using Karma (video)](http://www.youtube.com/watch?v=YG5DEzaQBIc), {@link guide/unit-testing Unit testing}, {@link guide/services#unit-testing Testing services}, [Karma in Webstorm](http://blog.jetbrains.com/webstorm/2013/10/running-javascript-tests-with-karma-in-webstorm-7/)
30-
* **End-to-End Testing:** [Protractor](https://github.com/angular/protractor)
31+
* **Unit testing:** [Using Karma (video)](http://www.youtube.com/watch?v=YG5DEzaQBIc), [Karma in Webstorm](http://blog.jetbrains.com/webstorm/2013/10/running-javascript-tests-with-karma-in-webstorm-7/)
3132

3233
#### Mobile
3334

@@ -79,7 +80,7 @@ This is a collection of external, 3rd party resources for learning and developin
7980
## Complementary Libraries
8081

8182
This is a list of libraries that enhance Angular, add common UI components or integrate with other libraries.
82-
You can find a full list of Angular external libraries at [ngmodules.org](http://ngmodules.org/).
83+
You can find a larger list of Angular external libraries at [ngmodules.org](http://ngmodules.org/).
8384

8485
* **Advanced Routing:** [UI-Router](https://github.com/angular-ui/ui-router)
8586
* **Authentication:** [Http Auth Interceptor](https://github.com/witoldsz/angular-http-auth)
@@ -98,6 +99,12 @@ You can find a full list of Angular external libraries at [ngmodules.org](http:/
9899
* **Fileupload:**
99100
- [ng-file-upload](https://github.com/danialfarid/ng-file-upload)
100101
- [blueimp-fileupload for Angular](https://blueimp.github.io/jQuery-File-Upload/angularjs.html)
102+
* **General UI Libraries:**
103+
- [Angular Material](https://material.angularjs.org/latest/)
104+
- [Angular UI Bootstrap](http://angular-ui.github.io/)
105+
- [AngularStrap for Bootstrap 3](http://mgcrea.github.io/angular-strap/)
106+
- [KendoUI](http://kendo-labs.github.io/angular-kendo/#/)
107+
- [Wijmo](http://wijmo.com/tag/angularjs-2/)
101108
* **Specific UI Elements:**
102109
- [ngInfiniteScroll](https://sroze.github.io/ngInfiniteScroll/)
103110
- [ngTable](https://github.com/esvit/ng-table)
@@ -106,12 +113,6 @@ You can find a full list of Angular external libraries at [ngmodules.org](http:/
106113
- [textAngular Rich Text Editor / contenteditable](http://textangular.com/) (Rich Text Editor /
107114
binding to contenteditable)
108115
- [Angular UI Map (Google Maps)](https://github.com/angular-ui/ui-map)
109-
* **General UI Libraries:**
110-
- [AngularStrap for Bootstrap 3](http://mgcrea.github.io/angular-strap/)
111-
- [Angular Material](https://material.angularjs.org/latest/)
112-
- [Angular UI Bootstrap](http://angular-ui.github.io/)
113-
- [KendoUI](http://kendo-labs.github.io/angular-kendo/#/)
114-
- [Wijmo](http://wijmo.com/tag/angularjs-2/)
115116

116117
## General Learning Resources
117118

docs/content/guide/index.ngdoc

+35-22
Original file line numberDiff line numberDiff line change
@@ -2,22 +2,23 @@
22
@name Developer Guide
33
@description
44

5-
# Guide to AngularJS Documentation
5+
# Guide to Angular 1 Documentation
66

77
On this page, you will find a list of official Angular resources on various topics.
8-
We have also set up a guide page for {@link guide/external external resources} where you
9-
can find lots of additional information and material on these topics, a list of complimentary
10-
libraries, and much more.
118

12-
## Tutorial
9+
Just starting out with Angular 1? Try working through our step by step tutorial or try
10+
building on our seed project.
1311

14-
* {@link tutorial/index Official AngularJS Tutorial}
12+
* {@link tutorial/index Official Angular 1 Tutorial}
13+
* [Angular Seed](https://github.com/angular/angular-seed)
1514

16-
## Core Concepts
15+
Ready to find out more about Angular 1?
1716

18-
* {@link guide/introduction What is AngularJS?}
17+
* {@link guide/introduction What is Angular 1?}
1918
* {@link guide/concepts Conceptual Overview}
2019

20+
## Core Concepts
21+
2122
### Templates
2223

2324
In Angular applications, you move the job of filling page templates with data from the server to the client. The result is a system better structured for dynamic page updates. Below are the core features you'll use.
@@ -38,7 +39,7 @@ In Angular applications, you move the job of filling page templates with data fr
3839
* **Bootstrap:** {@link guide/bootstrap Bootstrapping an app}
3940
* **Communicating with servers:** {@link ng.$http $http}, {@link ngResource.$resource $resource}
4041

41-
### Other AngularJS Features
42+
### Other Features
4243

4344
* **Animation:** {@link guide/animations Core concepts}, {@link ngAnimate ngAnimate API}
4445
* **Security:** {@link guide/security Security Docs}, {@link ng.$sce Strict Contextual Escaping}, {@link ng.directive:ngCsp Content Security Policy}, {@link ngSanitize.$sanitize $sanitize}, [video](https://www.youtube.com/watch?v=18ifoT-Id54)
@@ -48,32 +49,44 @@ In Angular applications, you move the job of filling page templates with data fr
4849

4950
### Testing
5051

51-
* **Unit testing:** {@link guide/unit-testing Unit testing}, {@link guide/services#unit-testing Testing services},
52-
* **Scenario / e2e testing:** {@link guide/e2e-testing e2e testing guide}
52+
* **Unit testing:** [Karma](http://karma-runner.github.io), {@link guide/unit-testing Unit testing}, {@link guide/services#unit-testing Testing services},
53+
* **End-to-End Testing:** [Protractor](https://github.com/angular/protractor), {@link guide/e2e-testing e2e testing guide}
54+
5355

54-
## Starter project template
56+
## Community Resources
57+
58+
We have set up a guide to many resources provided by the community, where you can find lots
59+
of additional information and material on these topics, a list of complimentary libraries, and much more.
60+
61+
* {@link guide/external-resources External Angular 1 resources}
5562

56-
* (https://github.com/angular/angular-seed)[Angular Seed]
5763

5864
## Getting Help
5965

6066
The recipe for getting help on your unique issue is to create an example that could work (even if it doesn't) in a shareable example on [Plunker](http://plnkr.co/), [JSFiddle](http://jsfiddle.net/), or similar site and then post to one of the following:
6167

6268
* [Stackoverflow.com](http://stackoverflow.com/search?q=angularjs)
63-
* [AngularJS mailing list](https://groups.google.com/forum/#!forum/angular)
64-
* [AngularJS IRC channel](http://webchat.freenode.net/?channels=angularjs&uio=d4)
69+
* [Angular 1 mailing list](https://groups.google.com/forum/#!forum/angular)
70+
* [Angular 1 IRC channel](http://webchat.freenode.net/?channels=angularjs&uio=d4)
71+
72+
## Official Communications
6573

66-
## Official Channels
74+
Official announcements, news and releases are posted to our blog, G+ and Twitter:
6775

68-
* **Official news and releases:** [AngularJS Blog](http://blog.angularjs.org/), [Google+](https://plus.google.com/u/0/+AngularJS), [Twitter](https://twitter.com/angularjs), [Angular on YouTube](http://youtube.com/angularjs)
76+
* [Angular Blog](http://blog.angularjs.org/)
77+
* [Google+](https://plus.google.com/u/0/+AngularJS)
78+
* [Twitter](https://twitter.com/angularjs)
79+
* [Angular on YouTube](http://youtube.com/angularjs)
6980

70-
## Contributing to AngularJS
81+
## Contributing to Angular 1
7182

72-
Though we have a core group of core contributors at Google, Angular is an open source project with hundreds of contributors. We'd love you to be one of them. When you're ready, please read the {@link misc/contribute Guide for contributing to AngularJS}.
83+
Though we have a core group of core contributors at Google, Angular is an open source project with hundreds of contributors.
84+
We'd love you to be one of them. When you're ready, please read the {@link misc/contribute Guide for contributing to Angular}.
7385

74-
## Final Bits
86+
## Something Missing?
7587

76-
Didn't find what you're looking for here? We have set up a special page for all external
88+
Didn't find what you're looking for here? Check out the {@link guide/external-resources External Angular 1 resources guide}.
7789

78-
If you have awesome AngularJS resources that belong on this page, please tell us about them on [Google+](https://plus.google.com/u/0/+AngularJS) or [Twitter](https://twitter.com/angularjs).
90+
If you have awesome Angular 1 resources that belong on that page, please tell us about them on
91+
[Google+](https://plus.google.com/u/0/+AngularJS) or [Twitter](https://twitter.com/angularjs).
7992

0 commit comments

Comments
 (0)