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

Commit a72bc4e

Browse files
Sharondiobtford
authored andcommitted
docs(tutorial/index): improve accessibility
- Adds accessibility attributes to links and images. - Adds a note on using NVM for node.
1 parent 0812061 commit a72bc4e

File tree

1 file changed

+36
-27
lines changed

1 file changed

+36
-27
lines changed

docs/content/tutorial/index.ngdoc

+36-27
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,8 @@ the construction of an AngularJS web app. The app you will build is a catalog th
99
of Android devices, lets you filter the list to see only devices that interest you, and then view
1010
details for any device.
1111

12-
<img class="diagram" src="img/tutorial/catalog_screen.png" width="488" height="413">
12+
<img class="diagram" src="img/tutorial/catalog_screen.png" width="488" height="413" alt="demo
13+
application running in the browser">
1314

1415
Work through the tutorial to see how Angular makes browsers smarter — without the use of extensions
1516
or plug-ins. As you work through the tutorial, you will:
@@ -57,63 +58,71 @@ and follow the instructions for setting up your computer.
5758
<div class="tab-pane well" id="git-mac" title="Git on Mac/Linux">
5859
<ol>
5960
<li><p>You'll need Git, which you can get from
60-
<a href="http://git-scm.com/download">the Git site</a>.</p></li>
61+
<a href="http://git-scm.com/download" title="Git site download">the Git site</a>.</p></li>
6162
<li><p>Clone the angular-phonecat repository located at
62-
<a href="https://github.com/angular/angular-phonecat">Github</a> by running the following command:</p>
63+
<a href="https://github.com/angular/angular-phonecat" title="Github Phonecat Repo">Github</a> by
64+
running the following command:</p>
6365
<pre>git clone https://github.com/angular/angular-phonecat.git</pre>
64-
<p>This command creates the <code>angular-phonecat</code> directory in your current
65-
directory.</p></li>
66+
<p>This command creates the <code>angular-phonecat</code> directory in your current directory.</p></li>
6667
<li><p>Change your current directory to <code>angular-phonecat</code>:</p>
6768
<pre>cd angular-phonecat</pre>
68-
<p>The tutorial instructions, from now on, assume you are running all commands from the <code>angular-phonecat</code>
69-
directory.</p></li>
69+
<p>The tutorial instructions, from now on, assume you are running all commands from the
70+
<code>angular-phonecat</code> directory.</p></li>
7071
<li><p>You will also need Node.js and Karma to run unit tests, so please verify that you have
71-
<a href="http://nodejs.org/">Node.js</a> v0.10 or better installed
72+
<a href="http://nodejs.org/" title="NodeJS org">Node.js</a> v0.10 or better installed
7273
and that the <code>node</code> executable is on your <code>PATH</code> by running the following
7374
command in a terminal window:</p></li>
7475
<pre>node --version</pre>
75-
<p>Additionally install <a href="http://karma-runner.github.io/">Karma</a> and its plugins if you
76-
don't have it already:</p>
76+
<div class="alert alert-info">**Helpful note:** If you need to run a different version of
77+
node.js in your local environment, consider installing
78+
<a href="https://github.com/creationix/nvm" title="Node Version Manager Github Repo link">
79+
Node Version Manager (nvm)</a>.</div>
80+
<p>Additionally install <a href="http://karma-runner.github.io/" title="Karma site">Karma</a> and
81+
its plugins if you don't have it already:</p>
7782
<pre>
7883
npm install
7984
</pre></li>
8085
<li><p>You will need an http server running on your system. Mac and Linux machines typically
81-
have Apache pre-installed, but If you don't already have one installed, you can use <code>node</code>
82-
to run a simple bundled http server: <code>node scripts/web-server.js</code>.</p></li>
86+
have Apache pre-installed, but If you don't already have one installed, you can use <code>node</code>
87+
to run <code>scripts/web-server.js</code>, a simple bundled http server.</p></li>
8388
</ol>
8489
</div>
8590

8691
<div class="tab-pane well" id="git-win" title="Git on Windows">
8792
<ol>
8893
<li><p>You will need Node.js and Karma to run unit tests, so please verify that you have
89-
<a href="http://nodejs.org/">Node.js</a> v0.10 or better installed
94+
<a href="http://nodejs.org/" title="NodeJS site">Node.js</a> v0.10 or better installed
9095
and that the <code>node</code> executable is on your <code>PATH</code> by running the following
9196
command in a terminal window:</p>
9297
<pre>node --version</pre>
93-
<p>Additionally install <a href="http://karma-runner.github.io/">Karma</a> if you
94-
don't have it already:</p>
98+
<div class="alert alert-info">**Helpful note:** If you need to run a different version of
99+
node.js in your local environment, consider installing
100+
<a href="https://github.com/creationix/nvm" title="Node Version Manager Github Repo link">
101+
Node Version Manager (nvm)</a>.</div>
102+
<p>Additionally install <a href="http://karma-runner.github.io/" title="Karma site">Karma</a>
103+
if you don't have it already:</p>
95104
<pre>npm install -g karma</pre>
96105
</li>
97106
<li><p>You'll also need Git, which you can get from
98-
<a href="http://git-scm.com/download">the Git site</a>.</p></li>
107+
<a href="http://git-scm.com/download" title="Git site download">the Git site</a>.</p></li>
99108
<li><p>Clone the angular-phonecat repository located at <a
100-
href="https://github.com/angular/angular-phonecat">Github</a> by running the following command:</p>
101-
<pre>git clone https://github.com/angular/angular-phonecat.git</pre>
109+
href="https://github.com/angular/angular-phonecat" "Github Angular-phonecat Repo">Github</a> by running
110+
the following command:</p><pre>git clone https://github.com/angular/angular-phonecat.git</pre>
102111
<p>This command creates the <code>angular-phonecat</code> directory in your current directory.</p></li>
103112
<li><p>Change your current directory to <code>angular-phonecat</code>:</p>
104113
<pre>cd angular-phonecat</pre>
105114
<p>The tutorial instructions assume you are running all commands from the <code>angular-phonecat</code>
106-
directory.</p>
115+
directory.</p>
107116
<p>You should run all <code>git</code> commands from Git bash.</p>
108-
<p>Other commands like <code>test.bat</code> or <code>e2e-test.bat</code> should be
109-
executed from the Windows command line.</li>
110-
<li><p>You need an http server running on your system, but if you don't already have one
111-
already installed, you can use <code>node</code> to run a simple
112-
bundled http server: <code>node scripts\web-server.js</code>.</p></li>
117+
<p>Other commands like <code>test.bat</code> or <code>e2e-test.bat</code> should be executed from the
118+
Windows command line.</li>
119+
<li><p>You need an http server running on your system, but if you don't already have one already
120+
installed, you can use <code>node</code> to run <code>scripts\web-server.js</code>, a simple bundled
121+
http server.</p></li>
113122
</ol>
114123
</div>
115124

116-
The last thing to do is to make sure your computer has a web browser and a good text editor
117-
installed. Now, let's get some cool stuff done!
125+
The last thing to do is to make sure your computer has a web browser and a good text editor installed. Now,
126+
let's get some cool stuff done!
118127

119-
{@link step_00 <span class="btn btn-primary">Get Started!</span>}
128+
<a href="tutorial/step_00" title="Next Step"><span class="btn btn-primary">Get Started!</span></a>

0 commit comments

Comments
 (0)