diff --git a/public/docs/ts/latest/guide/security.jade b/public/docs/ts/latest/guide/security.jade
index 47cc4d0bb9..6ede32c090 100644
--- a/public/docs/ts/latest/guide/security.jade
+++ b/public/docs/ts/latest/guide/security.jade
@@ -1,17 +1,17 @@
block includes
include ../_util-fns
:marked
- This section describes Angular's built-in
- protections against common web application vulnerabilities and attacks such as cross-site
- scripting attacks. It does not cover application-level security, such as authentication (_Who is
- this user?_) or authorization (_What can this user do?_).
+ This page describes Angular's built-in
+ protections against common web-application vulnerabilities and attacks such as cross-site
+ scripting attacks. It doesn't cover application-level security, such as authentication (_Who is
+ this user?_) and authorization (_What can this user do?_).
For more information about the attacks and mitigations described below, see [OWASP Guide Project](https://www.owasp.org/index.php/Category:OWASP_Guide_Project).
+ifDocsFor('ts')
.l-main-section
:marked
- # Contents:
+ # Contents
* [Reporting vulnerabilities](#report-issues).
* [Best practices](#best-practices).
@@ -21,13 +21,12 @@ block includes
* [Auditing Angular applications](#code-review).
:marked
- Try the of the code shown in this page.
+ You can run the in Plunker and download the code from there.
.l-main-section
h2#report-issues Reporting vulnerabilities
:marked
- Email us at [security@angular.io](mailto:security@angular.io) to report vulnerabilities in
- Angular itself.
+ To report vulnerabilities in Angular itself, email us at [security@angular.io](mailto:security@angular.io).
For more information about how Google handles security issues, see [Google's security
philosophy](https://www.google.com/about/appsecurity/).
@@ -36,7 +35,7 @@ h2#report-issues Reporting vulnerabilities
h2#best-practices Best practices
:marked
* **Keep current with the latest Angular library releases.**
- We regularly update our Angular libraries, and these updates may fix security defects discovered in
+ We regularly update the Angular libraries, and these updates may fix security defects discovered in
previous versions. Check the Angular [change
log](https://github.com/angular/angular/blob/master/CHANGELOG.md) for security-related updates.
@@ -45,63 +44,65 @@ h2#best-practices Best practices
important security fixes and enhancements. Instead, share your Angular improvements with the
community and make a pull request.
- * **Avoid Angular APIs marked in the documentation as “[_Security Risk_](#bypass-security-apis).”**
+ * **Avoid Angular APIs marked in the documentation as “_Security Risk_.”**
+ For more information, see the [Trusting safe values](#bypass-security-apis) section of this page.
.l-main-section
h2#xss Preventing cross-site scripting (XSS)
:marked
[Cross-site scripting (XSS)](https://en.wikipedia.org/wiki/Cross-site_scripting) enables attackers
to inject malicious code into web pages. Such code can then, for example, steal user data (in
- particular, their login data) or perform actions impersonating the user. This is one of the most
+ particular, login data) or perform actions to impersonate the user. This is one of the most
common attacks on the web.
- To block XSS attacks, you must prevent malicious code from entering the DOM (Document Object Model). For example, if an
- attacker can trick you into inserting a `