diff --git a/src/alert/docs/readme.md b/src/alert/docs/readme.md
index fb8029a5a3..0982c205ea 100644
--- a/src/alert/docs/readme.md
+++ b/src/alert/docs/readme.md
@@ -1,5 +1,5 @@
 Alert is an AngularJS-version of bootstrap's alert.
 
-This directive can be used to generate alerts from the dynamic model data (using the ng-repeat directive);
+This directive can be used to generate alerts from the dynamic model data (using the `ng-repeat` directive);
 
-The presence of the "close" attribute determines if a close button is displayed
+The presence of the `close` attribute determines if a close button is displayed