Merge pull request #2290 from GSA/2234-relabel-guidance-to-how-to

2234 relabel guidance to how to

app/content/get-started.md

@@ -5,7 +5,7 @@
 Explore Notify, add team members, and practice [sending messages to teammates](/using-notify/trial-mode).
 
 2. ## Personalize content
-Learn how to [personalize messages](/using-notify/guidance) to increase response.
+Learn how to [personalize messages](/using-notify/how-to) to increase response.
 
 3. ## Check delivery status
 [Analyze the delivery](/using-notify/delivery-status) of your messages and download reports

app/main/views/index.py

@@ -217,11 +217,11 @@ def benchmark_performance():
     )
 
 
-@main.route("/using-notify/guidance")
+@main.route("/using-notify/how-to")
 @user_is_logged_in
-def guidance_index():
+def how_to():
     return render_template(
-        "views/guidance/index.html",
+        "views/how-to/index.html",
         navigation_links=using_notify_nav(),
     )
 
@@ -266,29 +266,29 @@ def join_notify():
     )
 
 
-@main.route("/using-notify/guidance/create-and-send-messages")
+@main.route("/using-notify/how-to/create-and-send-messages")
 @user_is_logged_in
 def create_and_send_messages():
     return render_template(
-        "views/guidance/create-and-send-messages.html",
+        "views/how-to/create-and-send-messages.html",
         navigation_links=using_notify_nav(),
     )
 
 
-@main.route("/using-notify/guidance/edit-and-format-messages")
+@main.route("/using-notify/how-to/edit-and-format-messages")
 @user_is_logged_in
 def edit_and_format_messages():
     return render_template(
-        "views/guidance/edit-and-format-messages.html",
+        "views/how-to/edit-and-format-messages.html",
         navigation_links=using_notify_nav(),
     )
 
 
-@main.route("/using-notify/guidance/send-files-by-email")
+@main.route("/using-notify/how-to/send-files-by-email")
 @user_is_logged_in
 def send_files_by_email():
     return render_template(
-        "views/guidance/send-files-by-email.html",
+        "views/how-to/send-files-by-email.html",
         navigation_links=using_notify_nav(),
     )
 

app/main/views/sub_navigation_dictionaries.py

@@ -2,7 +2,7 @@ def using_notify_nav():
     nav_items = [
         {"name": "Get started", "link": "main.get_started"},
         {
-            "name": "Best Practices",
+            "name": "Best practices",
             "link": "main.best_practices",
             "sub_navigation_items": [
                 {
@@ -33,8 +33,8 @@ def using_notify_nav():
         },
         {"name": "Trial mode", "link": "main.trial_mode_new"},
         {"name": "Tracking usage", "link": "main.pricing"},
-        {"name": "Delivery Status", "link": "main.message_status"},
-        {"name": "Guidance", "link": "main.guidance_index"},
+        {"name": "Delivery status", "link": "main.message_status"},
+        {"name": "How to", "link": "main.how_to"},
     ]
 
     return nav_items

app/navigation.py

@@ -54,7 +54,7 @@ class HeaderNavigation(Navigation):
             "pricing",
             "trial_mode_new",
             "message_status",
-            "guidance_index",
+            "how_to",
         },
         "accounts-or-dashboard": {
             "conversation",

app/templates/views/features.html

@@ -28,7 +28,7 @@ <h2 class="heading-medium" id="organizing-content">Organizing your content</h2>
 
 <h2 class="heading-medium" id="personalised-messages">Personalized content</h2>
 <p class="usa-body">Notify makes it easy to send personalized messages from a single template.</p>
-<p class="usa-body">See <a class="usa-link" href="{{ url_for('.guidance_index', _anchor='personalized-content') }}">how to personalize your content</a>.</p>
+<p class="usa-body">See <a class="usa-link" href="{{ url_for('.how_to', _anchor='personalized-content') }}">how to personalize your content</a>.</p>
 
 <h2 class="heading-medium" id="bulk-sending">Bulk sending</h2>
 <p class="usa-body">To send a batch of messages at once, upload a list of contact details to Notify. You can also schedule the date and time you want them to be sent.</p>

app/templates/views/guides/benchmark-performance.html

@@ -8,7 +8,7 @@
 {% endblock %}
 
 {% block content_column_content %}
-{{ breadcrumbs.breadcrumb(page_title, "Best Practices", "main.best_practices") }}
+{{ breadcrumbs.breadcrumb(page_title, "Best practices", "main.best_practices") }}
 
 <section class="usa-prose">
   <h1>{{page_title}}</h1>

app/templates/views/guides/best-practices.html

@@ -1,14 +1,14 @@
 {% extends "base.html" %}
 
-{% set page_title = "Best Practices" %}
+{% set page_title = "Best practices" %}
 
 {% block per_page_title %}
 {{page_title}}
 {% endblock %}
 
 {% block content_column_content %}
 <section class="usa-prose">
-  <h1>Best Practices</h1>
+  <h1>Best practices</h1>
   <p class="font-sans-lg text-base">For texting the public</p>
   <p>Effectively reaching your audience and supporting your program’s goals starts with strategically planning out what
     text messages can help you achieve and how to approach a thoughtful rollout.

app/templates/views/guides/clear-goals.html

@@ -8,7 +8,7 @@
 {% endblock %}
 
 {% block content_column_content %}
-{{ breadcrumbs.breadcrumb(page_title, "Best Practices", "main.best_practices") }}
+{{ breadcrumbs.breadcrumb(page_title, "Best practices", "main.best_practices") }}
 
 <section class="usa-prose">
   <h1>{{page_title}}</h1>

app/templates/views/guides/establish-trust.html

@@ -10,7 +10,7 @@
 {% endblock %}
 
 {% block content_column_content %}
-{{ breadcrumbs.breadcrumb(page_title, "Best Practices", "main.best_practices") }}
+{{ breadcrumbs.breadcrumb(page_title, "Best practices", "main.best_practices") }}
 
 <section class="usa-prose">
   <h1>{{page_title}}</h1>

app/templates/views/guides/multiple-languages.html

@@ -8,7 +8,7 @@
 {% endblock %}
 
 {% block content_column_content %}
-{{ breadcrumbs.breadcrumb(page_title, "Best Practices", "main.best_practices") }}
+{{ breadcrumbs.breadcrumb(page_title, "Best practices", "main.best_practices") }}
 
 <section class="usa-prose">
   <h1>{{page_title}}</h1>

app/templates/views/guides/rules-and-regulations.html

@@ -8,7 +8,7 @@
 {% endblock %}
 
 {% block content_column_content %}
-{{ breadcrumbs.breadcrumb(page_title, "Best Practices", "main.best_practices") }}
+{{ breadcrumbs.breadcrumb(page_title, "Best practices", "main.best_practices") }}
 
 <section class="usa-prose">
   <h1>{{page_title}}</h1>

app/templates/views/guides/write-for-action.html

@@ -9,7 +9,7 @@
 {% endblock %}
 
 {% block content_column_content %}
-{{ breadcrumbs.breadcrumb(page_title, "Best Practices", "main.best_practices") }}
+{{ breadcrumbs.breadcrumb(page_title, "Best practices", "main.best_practices") }}
 
 <section class="usa-prose">
   <h1>{{page_title}}</h1>

app/templates/views/guidance/index.html → app/templates/views/how-to/index.html

@@ -4,11 +4,11 @@
 {% from "components/service-link.html" import service_link %}
 
 {% block per_page_title %}
-  Guidance
+  How to
 {% endblock %}
 
 {% block content_column_content %}
-<h1 class="font-body-2xl margin-bottom-3">Guidance</h1>
+<h1 class="font-body-2xl margin-bottom-3">How to</h1>
 
 <p>Notify allows you to easily create templates for messages for your recipients. You can customize messages to encourage
 your recipient to manage their benefits and increase follow-through.</p>
@@ -61,7 +61,7 @@ <h3>To personalize your content</h3>
 <ol class="list">
   <li>Add a placeholder to your content by placing two brackets around the personalized elements.</li>
   <li>You can manually enter the personalized content or you can upload a spreadsheet with the details and let Notify do the
-  work for you. See <a href="#prepare-data">data preparation</a>.</li>
+  work for you.</li>
 </ol>
 
 <h4>Example</h4>
@@ -80,7 +80,7 @@ <h3>To add conditional content</h3>
 <ol class="list">
   <li>Use two brackets and ?? to define the conditional content.</li>
   <li>You can manually enter the conditional content or you can upload a spreadsheet with the personal details and let Notify
-  do the work for you. See <a href="#prepare-data">data preparation</a>.</li>
+  do the work for you.</li>
 </ol>
 
 <h4>Examples</h4>

app/templates/views/support/index.html

@@ -13,8 +13,8 @@
   <h1 class="font-body-2xl margin-bottom-3">Contact us</h1>
   <p>Notify is designed to be easy to use.</p>
   <ul class="list list-bullet">
-    <li>For information on personalization and data preparation, see <a href={{ url_for("main.guidance_index") }}>Guidance</a>.</li>
-    <li>For help interpreting delivery reports, see <a href={{ url_for("main.message_status") }}>Delivery Status</a>.</li>
+    <li>For information on personalization, see <a href={{ url_for("main.how_to") }}>How to</a>.</li>
+    <li>For help interpreting delivery reports, see <a href={{ url_for("main.message_status") }}>Delivery status</a>.</li>
     <li>For details on pricing and what counts as a message part, see <a href={{ url_for("main.pricing") }}>Pricing</a>.</li>
   </ul>
 

tests/app/main/views/test_index.py

@@ -94,7 +94,7 @@ def test_hiding_pages_from_search_engines(
         "message_status",
         "how_to_pay",
         "get_started",
-        "guidance_index",
+        "how_to",
         "create_and_send_messages",
         "edit_and_format_messages",
         "send_files_by_email",

tests/app/test_navigation.py

@@ -111,7 +111,7 @@
             "get_started_old",
             "go_to_dashboard_after_tour",
             "guest_list",
-            "guidance_index",
+            "how_to",
             "history",
             "how_to_pay",
             "inbound_sms_admin",

urls.js

@@ -8,7 +8,7 @@ const sublinks = [
   { label: 'Trial Mode', path: '/using-notify/trial-mode' },
   { label: 'Pricing', path: '/using-notify/pricing' },
   { label: 'Delivery Status', path: '/using-notify/delivery-status' },
-  { label: 'Guidance', path: '/using-notify/guidance' },
+  { label: 'How To', path: '/using-notify/how-to' },
   { label: 'Support', path: '/support' },
   { label: 'Best Practices', path: '/using-notify/best-practices' },
   { label: 'Clear Goals', path: '/using-notify/best-practices/clear-goals' },