-### Pasting the following lines at a shell prompt will allow Arvados SDKs</br>
-### to authenticate to your account, <%= current_user.email %></br>
-export ARVADOS_API_TOKEN=<%= Thread.current[:arvados_api_token] %></br>
-export ARVADOS_API_TOKEN ARVADOS_API_HOST=<%= current_api_host %></br>
+<p>The Arvados API token is a secret key that enables the Arvados SDKs to access Arvados with the proper permissions. For more information see <%= link_to raw('Getting an API token'), "#{Rails.configuration.arvados_docsite}/user/reference/api-tokens.html", target: "_blank"%>.</p>
+<p>Paste the following lines at a shell prompt to set up the necessary environment for Arvados SDKs to authenticate to your account, <b><%= current_user.email %></b></p>
+
+<pre>
+HISTIGNORE=$HISTIGNORE:'export ARVADOS_API_TOKEN=*'
+export ARVADOS_API_TOKEN=<%= Thread.current[:arvados_api_token] %>
+export ARVADOS_API_HOST=<%= current_api_host %>
<% if Rails.configuration.arvados_insecure_https %>
-export ARVADOS_API_HOST_INSECURE=true</br>
+export ARVADOS_API_HOST_INSECURE=true
<% else %>
-unset ARVADOS_API_HOST_INSECURE</br>
+unset ARVADOS_API_HOST_INSECURE
<% end %>
+</pre>