Add hyperlinks to resources.

app/views/home/faq.html.erb

@@ -19,46 +19,46 @@
   <p>DocumentCloud is a web-based software platform for organizing, researching, annotating, and publishing primary source documents. We offer a set of tools that help you find and tell stories in your documents.</p>
 
   <p><b>How much does it cost?</b></p>
-  <p>Thanks to generous funding from the Knight Foundation, DocumentCloud since its launch in 2010 has been offered for free exclusively to journalism organizations. We are currently developing a paid model to ensure the DocumentCloud platform's sustainability, an effort you can read more about at the DocumentCloud blog.</p>
+  <p>Thanks to generous funding from the Knight Foundation, DocumentCloud since its launch in 2010 has been offered for free exclusively to journalism organizations. We are currently developing a paid model to ensure the DocumentCloud platform's sustainability, an effort you can read more about at the <a href="https://blog.documentcloud.org/blog/2015/12/making-documentcloud-sustainable/">DocumentCloud blog</a>.</p>
 
   <p><b>Who can have accounts?</b></p>
-  <p>Currently, we are offering accounts to journalists -- both those within news organizations and those with a demonstrated freelance portfolio. In addition, we are opening the platform on a trial basis to users in related industries who work with public documents. Please apply.</p>
+  <p>Currently, we are offering accounts to journalists -- both those within news organizations and those with a demonstrated freelance portfolio. In addition, we are opening the platform on a trial basis to users in related industries who work with public documents. Please <%= link_to 'apply', '/plans/apply' %>.</p>
 
   <p><b>Where can I get help?</b></p>
-  <p>You can find answers to most questions you have either in this FAQ or our Help documentation. If you can’t find the answer, or if you’re having trouble using DocumentCloud, please email us at support@documentcloud.org.
+  <p>You can find answers to most questions you have either in this FAQ or our <%= link_to 'Help documentation', '/help' %>. If you can’t find the answer, or if you’re having trouble using DocumentCloud, please email us at <a href="mailto:support@documentcloud.org">support@documentcloud.org</a>.
 
   <p><b>Where can I read your Terms of Service?</b></p>
-  <p>The current version, as well as past versions, are here.</p>
+  <p>The current version, as well as past versions, are <%= link_to 'here', '/terms' %>.</p>
 
   <h2>Privacy</h2>
   <p><b>What is DocumentCloud’s privacy policy?</b></p>
-  <p>Please read our complete Privacy Policy for details.</p>
+  <p>Please read our complete <%= link_to 'Privacy Policy', '/privacy' %> for details.</p>
 
   <p><b>Who can see documents in my account?</b></p>
   <p>By default, any document you upload is set to "private" access and is viewable only by you. If you set the access level to "private to [your organization name]," then other DocumentCloud users in your organization can view the document, but not the public.</p>
 
   <h2>Accounts</h2>
 
   <p><b>How do I get an account?</b></p>
-  <p>Start by filling out an application. Learn more about getting accounts at our Contact page.</p>
+  <p>Start by filling out an <%= link_to 'application', '/plans/apply' %>. Learn more about getting accounts at our <%= link_to 'contact', '/contact' %> page.</p>
 
   <p><b>How does DocumentCloud organize accounts?</b></p>
   <p>Currently, we create accounts under the umbrella of an organization. That is, each user account is tied to at least one organization. This allows, for example, users within that organization to collaborate privately on documents.</p>
 
   <p><b>How do I log in and log out?</b></p>
-  <p>To log in, on the DocumentCloud home page, enter your account email address and password in the login box. To log out, click the "Log Out" link at the top right of the workspace. Note: Always log out when you’re done working if you’re logged in on a shared computer.</p>
+  <p>To log in, on the DocumentCloud home page, enter your account email address and password in the login box. To log out, click the "Log Out" link at the top right of the workspace. <i>Note: Always log out when you’re done working if you’re logged in on a shared computer.</i></p>
 
   <p><b>How do I reset my password?</b></p>
-  <p>If you’ve forgotten your password, go to our password reset page: https://www.documentcloud.org/reset_password</p>
+  <p>If you’ve forgotten your password, go to our <%= link_to 'password reset page', '/reset_password' %>.</p>
 
   <p><b>How do I change my email address and password?</b></p>
   <p>To change your email address, in the workspace, click the "Accounts" tab at top. Enter a new email address in the email box and click "Save." To change your password, Click the "Change Password" button, type your new password, and click "Save."</p>
 
   <p><b>Do I have to use my real name for my account?</b></p>
-  <p>Yes, the DocumentCloud Terms of Service require that accounts use real names and valid email addresses. However, we allow organizations to create one shared account for posting documents and another shared account for use with automation technology or our API. These accounts should have an appropriate name, such as "[Organization name] Documents."</p>
+  <p>Yes, the DocumentCloud <%= link_to 'Terms of Service', '/terms' %> require that accounts use real names and valid email addresses. However, we allow organizations to create one shared account for posting documents and another shared account for use with automation technology or our API. These accounts should have an appropriate name, such as "[Organization name] Documents."</p>
 
   <p><b>How can I get accounts for others in my organization?</b></p>
-  <p>Anyone in your organization who has a DocumentCloud account with administrator privileges can create accounts. Check around your organization, but if you’re not sure, email us at support@documentcloud.org</p>
+  <p>Anyone in your organization who has a DocumentCloud account with administrator privileges can create accounts. Check around your organization, but if you’re not sure, email us at <a href="mailto:support@documentcloud.org">support@documentcloud.org</a></p>
 
   <p><b>What are the differences between admin, contributor and freelancer accounts?</b></p>
   <p>The abilities are largely similar but with some notable exceptions:</p>
@@ -97,7 +97,7 @@
   <p>Currently, there is no limit.</p>
 
   <p><b>What happens if my organization closes?</b></p>
-  <p>Please notify DocumentCloud at support@documentcloud.org if your organization is closing, changing its name or experiencing another significant change. We value the documents uploaded and made public by our contributors and ask that you do not delete them. We will be glad to work with you on a transition plan.</p>
+  <p>Please notify DocumentCloud at <a href="mailto:support@documentcloud.org">support@documentcloud.org</a> if your organization is closing, changing its name or experiencing another significant change. We value the documents uploaded and made public by our contributors and ask that you do not delete them. We will be glad to work with you on a transition plan.</p>
 
   <p><b>What happens to my documents and account if I leave my current organization?</b></p>
   <p>You are able at any time to download the original documents you uploaded to our service. Generally, we defer to each organization regarding disposition of the documents you uploaded to DocumentCloud while in their employment. Every organization has its own rules governing ownership of material generated while in their employment or service.</p>
@@ -107,10 +107,10 @@
 
   <h2>Search</h2>
 
-  <p><b>What can I find in the public catalog?</b></p>
-  <p>We feature more than 1.1 million documents provided by contributors ranging from The New York Times to The Guardian and hundreds of large and small news organizations, freelance journalists and others who report using public documents.</p>
+  <p><b>What can I find in the <%= link_to 'public catalog', '/public/search' %>?</b></p>
+  <p>We feature more than a million documents provided by contributors ranging from The New York Times to The Guardian and hundreds of large and small news organizations, freelance journalists and others who report using public documents.</p>
 
-  <p><b>Do I need an account to search the public catalog?</b></p>
+  <p><b>Do I need an account to search the <%= link_to 'public catalog', '/public/search' %>?</b></p>
   <p>No, you do not. We are proud to provide a valuable public resource at no cost.</p>
 
   <p><b>Will getting a DocumentCloud account allow me to see more documents?</b></p>
@@ -130,7 +130,7 @@
   <p>Yes, 400 MB is the largest file you can upload.</p>
 
   <p><b>Are there restrictions on the content of documents I can upload?</b></p>
-  <p>DocumentCloud is intended to be a repository of public documents. Our Terms of Service prohibits uploading copyrighted material that is not yours.</p>
+  <p>DocumentCloud is intended to be a repository of public documents. Our <%= link_to 'Terms of Service', '/terms' %> prohibits uploading copyrighted material that is not yours.</p>
 
   <p><b>How long does it take to process a document?</b></p>
   <p>Processing times will vary depending on the size of the file, whether or not it needs to be OCR’d, and current activity on the platform. Small documents are usually processed in a minute or less; larger documents can take significantly longer.</p>
@@ -145,7 +145,7 @@
   <p>Yes, we offer OCR in more than 20 languages via the Tesseract OCR engine’s language packs. In the workspace under the "Accounts" tab, choose your preferred language for OCR under the "New documents" drop down. Then click "Save."</p>
 
   <p><b>I don’t see the language I need for OCR. Can you add it?</b></p>
-  <p>We are glad to add languages supported by Tesseract, the OCR engine we use. Please see https://en.wikipedia.org/wiki/Tesseract_(software) for a list of languages and contact us at support@documentcloud.org to discuss your needs.</p>
+  <p>We are glad to add languages supported by Tesseract, the OCR engine we use. Please see <a href="https://en.wikipedia.org/wiki/Tesseract_(software)">en.wikipedia.org/wiki/Tesseract_(software)</a> for a list of languages and contact us at <a href="mailto:support@documentcloud.org">support@documentcloud.org</a> to discuss your needs.</p>
 
   <h2>Working with Documents</h2>
 
@@ -156,7 +156,7 @@
   <p>Use the Related Article URL to tell readers the location of the article that uses this document as source material. Adding a URL in this field creates a Related Article link in the sidebar of the full viewer. The Published URL is the page where the document is embedded. Most users won't need to provide this — our platform can usually detect where the document is embedded. If a document might be accessed at more than one URL, however, you can specify the URL we should send users to if they find the document through a search of DocumentCloud.</p>
 
   <p><b>How can I add custom data (tags) to organize and search my documents?</b></p>
-  <p>DocumentCloud allows you to define and search your own set of custom data (key/value pairs) associated with specific documents. To edit data for individual documents in the workspace, select the documents you wish to update, and choose "Edit Document Data" from the "Edit" menu. See "Editing and Searching your own Custom Data" in our Help section to learn more.</p>
+  <p>DocumentCloud allows you to define and search your own set of custom data (key/value pairs) associated with specific documents. To edit data for individual documents in the workspace, select the documents you wish to update, and choose "Edit Document Data" from the "Edit" menu. See "Editing and Searching your own Custom Data" in our <%= link_to 'Help', '/help/searching' %> section to learn more.</p>
 
   <p><b>How do I change the order of pages in a document I uploaded?</b></p>
   <p>Double-click the document to open it in the document workspace. In the sidebar, click "Reorder Pages." You’ll see thumbnails of all the pages in your document. Drag and drop pages into the order you’d like, then click "Save Page Order."</p>
@@ -174,7 +174,7 @@
   <p>We recommend you retain a backup of your document before removing pages. To remove one or more pages:</p>
   <ul style="list-style-type: disc;margin-left:20px">
       <li>Double-click the document to open it in the document workspace. In the sidebar, click "Remove Pages." You’ll see thumbnails of all the pages in your document.</li>
-      <li>Select the pages you’d like to delete from your document, and then click "Remove X Pages."</li>
+      <li>Select the pages you’d like to delete from your document, and then click "Remove [X] Pages."</li>
       <li>Note that once you remove pages they are permanently deleted and your original document is replaced.</li>
   </ul>
 
@@ -326,7 +326,7 @@
   <p>DocumentCloud provides a wizard that walks you through the steps of generating codes for each type of embed. You then typically add the embed code to your website using your content management system’s embed function.</p>
 
   <p><b>Will DocumentCloud work with my CMS?</b></p>
-  <p>DocumentCloud’s used by hundreds of organizations worldwide with many different content management systems. If your CMS offers the ability to embed snippets of JavaScript and HTML, you should be fine. We’re available to talk with your CMS’s developers to iron out any questions. Please contact us at support@documentcloud.org.</p>
+  <p>DocumentCloud’s used by hundreds of organizations worldwide with many different content management systems. If your CMS offers the ability to embed snippets of JavaScript and HTML, you should be fine. We’re available to talk with your CMS’s developers to iron out any questions. Please contact us at <a href="mailto:support@documentcloud.org">support@documentcloud.org</a></p>
 
   <p><b>Do embeds work on phones?</b></p>
   <p>Yes, all of our embed types can be viewed on phone or tablet screens. However, our page and note embeds are responsive and will work best on those devices.</p>
@@ -349,15 +349,15 @@
   <h2>DocumentCloud's API</h2>
 
   <p><b>What is the DocumentCloud API?</b></p>
-  <p>DocumentCloud's API provides resources to search, upload, edit, and organize documents as well as to work with projects. In addition, an oEmbed service provides easy integration of embedding documents, pages and notes. Full documentation is available.</p>
+  <p>DocumentCloud's API provides resources to search, upload, edit, and organize documents as well as to work with projects. In addition, an oEmbed service provides easy integration of embedding documents, pages and notes. Full <%= link_to 'documentation', '/help/api' %> is available.</p>
 
   <p><b>Do you need a DocumentCloud account to use the API?</b></p>
-  <p>As with DocumentCloud’s workspace, you need an account to use the API to upload, update or delete documents, or create and modify projects. Other API functions, such as search, do not require an account. Consult the documentation for details.</p>
+  <p>As with DocumentCloud’s workspace, you need an account to use the API to upload, update or delete documents, or create and modify projects. Other API functions, such as search, do not require an account. Consult the <%= link_to 'documentation', '/help/api' %> for details.</p>
 
   <p><b>What libraries are available for working with the API?</b></p>
-  <p>The open-source community has contributed several helpful libraries for interacting with DocumentCloud's API. These include Python, Ruby and Node.js wrappers. See the listing in the API documentation.</p>
+  <p>The open-source community has contributed several helpful libraries for interacting with DocumentCloud's API. These include Python, Ruby and Node.js wrappers. See the listing in the API <%= link_to 'documentation', '/help/api' %>.</p>
 
   <p><b>Are there limits on API use?</b></p>
-  <p>Yes. Please read our complete API Guidelines and Terms of Service.</p>
+  <p>Yes. Please read our complete <%= link_to 'API Guidelines and Terms of Service', '/terms/api' %>.</p>
 
  </div>