Modify copy on About and Explore Tool pages (#974)

* Modify copy - update snapshots * Fix failing cypress tests - commented out lat/lng in URL test as it is intermittent * Removes test on EO link * Update copy for launch - adds 404 page verbiage - fixes survey button to be bottom sticky * Update copy
2025-10-01 10:03:18 -07:00 · 2021-12-08 13:15:31 -05:00 · 2021-12-08 13:15:31 -05:00 · 1f5742bc5b
commit 1f5742bc5b
parent df675b231a
21 changed files with 240 additions and 172 deletions
--- a/client/src/data/copy/404.tsx
+++ b/client/src/data/copy/404.tsx
@ -1,4 +1,6 @@
+import React from 'react';
 import {defineMessages} from 'react-intl';
+import {FormattedMessage, Link} from 'gatsby-plugin-intl';

 export const PAGE = defineMessages({
  TITLE: {
@ -11,24 +13,22 @@ export const PAGE = defineMessages({
    defaultMessage: 'Page not found',
    description: 'page not found heading text',
  },
-  APOLOGY: {
-    id: 'pageNotFound.apology.text',
-    defaultMessage: 'Sorry',
-    description: 'page not found apology text',
-  },
-  APOLOGY_INFO: {
-    id: 'pageNotFound.apology.description.text',
-    defaultMessage: 'we couldn’t find what you were looking for.',
-    description: 'page not found apology description text',
-  },
  GUIDANCE: {
    id: 'pageNotFound.Guidance.text',
    defaultMessage: 'Try creating a page in',
    description: 'page not found guidance text',
  },
-  LINK_HOME: {
-    id: 'pageNotFound.link.to.go.home.text',
-    defaultMessage: 'Go home',
-    description: 'page not found link to go home text',
-  },
 });
+
+export const ERROR_MSG =
+<FormattedMessage
+  id={'pageNotFound.apology.text'}
+  defaultMessage={`
+    Sorry, the page you were looking for was not found. Click {home} to go home.
+    `}
+  description={'page description'}
+  values={{
+    home: <Link to={'/'}>here</Link>,
+    homeEs: <Link to={'/methodology'}>aqui</Link>,
+  }}
+/>;
--- a/client/src/data/copy/about.tsx
+++ b/client/src/data/copy/about.tsx
@ -1,4 +1,8 @@
+import React from 'react';
 import {defineMessages} from 'react-intl';
+import {FormattedMessage} from 'gatsby-plugin-intl';
+
+export const EXEC_ORDER_LINK = 'https://www.federalregister.gov/documents/2021/02/01/2021-02177/tackling-the-climate-crisis-at-home-and-abroad#:~:text=Sec.%20223.%20Justice40,40-percent%20goal.';

 export const PAGE = defineMessages({
  TILE: {
@ -13,12 +17,12 @@ export const PAGE = defineMessages({
  },
  HEADING_1: {
    id: 'index.heading.screentool',
-    defaultMessage: 'The screening tool',
+    defaultMessage: 'Screening tool',
    description: 'heading for about screening tool',
  },
  HEADING1_DESCRIPTION1: {
    id: 'about.page.sub.header.1.text.1',
-    defaultMessage: 'On January 27, 2021, President Biden directed the Council on'+
+    defaultMessage: 'In Executive Order 14008 on Tackling the Climate Crisis at Home and Abroad'+
    ' Environmental Quality (CEQ) to create a climate and economic'+
    ' justice screening tool. The purpose of the tool is to help'+
    ' Federal agencies identify disadvantaged communities and provide'+
@ -32,12 +36,12 @@ export const PAGE = defineMessages({
  HEADING1_DESCRIPTION2: {
    id: 'about.page.sub.header.1.text.2',
    defaultMessage: 'The current version of the tool is in a public beta form and'+
-    ' will be updated based on feedback from the public.',
+    ' will be updated based on feedback and research.',
    description: 'about page sub header text',
  },
  HEADING_2: {
    id: 'index.heading.justice40',
-    defaultMessage: 'The Justice40 Initiative',
+    defaultMessage: 'Justice40 Initiative',
    description: 'heading for about justice 40',
  },
  HEADING2_DESCRIPTION1: {
@ -53,20 +57,54 @@ export const PAGE = defineMessages({
    ' critical clean water infrastructure.',
    description: 'about page sub header text',
  },
-  HEADING2_DESCRIPTION2: {
-    id: 'about.page.sub.header.2.text.2',
-    defaultMessage: 'Read more about the Justice40 Initiative in President Biden’s',
-    description: 'about page sub header text',
-  },
-  PRESIDENT_LINK_LABEL: {
-    id: 'index.presidentalLinkLabel',
-    defaultMessage: 'Executive Order 14008 on Tackling the Climate Crisis at Home and Abroad.',
-    description: 'Link url to presidential actions executive order. Part of paragraph 2',
-  },
 });

-export const EXEC_ORDER_LINK = 'https://www.whitehouse.gov/briefing-room/presidential-actions/2021/01/27/' +
-    'executive-order-on-tackling-the-climate-crisis-at-home-and-abroad/';
+export const HEADING_1 = {
+  DESCRIPTION_1:
+  <FormattedMessage
+    id={'about.page.sub.header.1.text.1'}
+    description={'about page sub header text'}
+    defaultMessage={`
+    In {eoLink} on Tackling the Climate Crisis at Home and Abroad,
+    President Biden directed the Council on 
+    Environmental Quality (CEQ) to create a Climate and Economic
+    Justice Screening Tool. The purpose of the tool is to help
+    Federal agencies identify disadvantaged communities 
+    that have been historically marginalized, underserved, and 
+    overburdened by pollution. The tool provides
+    socioeconomic, environmental, and climate information
+    to inform decisions that may affect these communities. The tool
+    identifies disadvantaged communities
+    through publicly available, nationally consistent, high-quality
+    data.
+    `}
+    values={{
+      eoLink:
+      <a href={EXEC_ORDER_LINK}>
+        Executive Order 14008
+      </a>,
+    }}
+  />,
+};
+
+export const HEADING_2 = {
+  DESCRIPTION_2:
+  <FormattedMessage
+    id={'about.page.sub.header.2.text.2'}
+    description={'about page sub header text'}
+    defaultMessage={`
+    Read more about the Justice40 Initiative in President Biden’s
+    {eoLink} on Tackling the Climate Crisis at Home and Abroad.
+    `}
+    values={{
+      eoLink:
+      <a href={EXEC_ORDER_LINK}>
+        Executive Order 14008
+      </a>,
+    }}
+  />,
+};
+

 export const GITHUB_LINK = 'https://github.com/usds/justice40-tool';

@ -83,14 +121,15 @@ export const HOW_TO_GET_STARTED = defineMessages({
  },
  FEDERAL_PM_INFO: {
    id: 'federal.pm.info',
-    defaultMessage: 'Download the screening tool’s draft list of communities of focus.'+
-    ' Explore data that may be useful to your program, and provide'+
-    ' feedback on the tool.',
+    defaultMessage: `
+      Download the tool’s current list of communities, explore data that may be useful to your 
+      program, and provide feedback on the tool.
+    `,
    description: 'sub heading of page',
  },
  FEDERAL_PM_LINK_TEXT: {
    id: 'federal.pm.link',
-    defaultMessage: 'Go to data & methodology',
+    defaultMessage: 'Methodology & data',
    description: 'link text to go to methodology page',
  },
  COMMUNITY_MEMBERS_HEADING: {
@ -100,8 +139,9 @@ export const HOW_TO_GET_STARTED = defineMessages({
  },
  COMMUNITY_MEMBERS_INFO: {
    id: 'community.members.info',
-    defaultMessage: 'Explore data about communities of focus in your area, and help '+
-    ' provide feedback on the tool.',
+    defaultMessage: `
+    Explore data about communities in your area and provide feedback on the tool.
+    `,
    description: 'sub heading of page',
  },
  COMMUNITY_MEMBERS_LINK_TEXT: {
--- a/client/src/data/copy/common.tsx
+++ b/client/src/data/copy/common.tsx
@ -39,7 +39,7 @@ export const HEADER = defineMessages({
  },
  METHODOLOGY: {
    id: 'header.methodology',
-    defaultMessage: 'Data & methodology',
+    defaultMessage: 'Methodology & data',
    description: 'Header navigate item to the Methodology page',
  },
  CONTACT: {
--- a/client/src/data/copy/explore.tsx
+++ b/client/src/data/copy/explore.tsx
@ -21,30 +21,34 @@ export const PAGE_INTRO = defineMessages({

 export const PAGE_DESCRIPTION = <FormattedMessage
  id={'exploreTool.page.description'}
-  defaultMessage={
-    `Zoom into the map to see communities of focus that can help Federal agencies
-  identify disadvantaged communities and to provide socioeconomic,
-  environmental, and climate information and data. Learn more about the methodology
-  and datasets that were used to determine these communities of focus on the
-    {methodologyLink}
-  page.`}
+  defaultMessage={`
+    Use the map to see disadvantaged communities that have been historically 
+    marginalized, underserved, and overburdened by pollution. The map uses 
+    publicly-available, nationally-consistent, high-quality datasets. Learn more about 
+    the methodology and datasets that were used to identify disavantaged communities 
+    on the {methodologyLink} page.
+    `}
  description={'page description'}
  values={{
-    methodologyLink: <Link to={'/methodology'}>Data & methodology</Link>,
-    methodologyLinkEs: <Link to={'/methodology'}>Datos y metodología</Link>,
+    methodologyLink: <Link to={'/methodology'}>methodology & data</Link>,
+    methodologyLinkEs: <Link to={'/methodology'}>metodología y datos</Link>,
  }}
 />;

 export const LEGEND = defineMessages({
  PRIORITY_LABEL: {
    id: 'legend.info.priority.label',
-    defaultMessage: 'Draft community of focus',
+    defaultMessage: 'Disadvantaged community',
    description: 'the label of the prioritized community legend',
  },
  PRIORITY_DESCRIPT: {
    id: 'legend.info.threshold.label',
-    defaultMessage: 'A community identified as experiencing disadvantages that merits' +
-      ' the focus of certain Federal investments, including through the Justice40 Initiative',
+    defaultMessage: `
+    Communities identified for the purposes of Justice40 as disadvantaged have been 
+    historically marginalized, underserved, and overburdened by pollution. These communities 
+    meet or exceed the criteria in one or more areas of focus. 
+
+    `,
    description: 'the label of the threshold community legend',
  },
 });
@ -153,7 +157,7 @@ export const MAP = defineMessages({
 export const SIDE_PANEL_INITIAL_STATE = defineMessages({
  TITLE: {
    id: 'mapIntro.mapIntroHeader',
-    defaultMessage: 'Zoom and select a census block group to view data',
+    defaultMessage: 'Zoom and select a census tract to view data',
    description: 'introductory text of ways to use the map',
  },
  DID_YOU_KNOW: {
@ -163,9 +167,13 @@ export const SIDE_PANEL_INITIAL_STATE = defineMessages({
  },
  CBG_DEFINITION: {
    id: 'mapIntro.censusBlockGroupDefinition',
-    defaultMessage: 'A census block group is generally between 600 and 3,000 people. ' +
-    'It is the smallest geographical unit for which the U.S. Census ' +
-    'Bureau publishes sample data.',
+    defaultMessage: `
+      A census tract is generally between 1,200 and 8,000 people, with an optimum size of 4,000 people. 
+      Census tracts are small, relatively permanent subdivisions of a county defined by the 
+      U.S. Census Bureau and usually cover a contiguous area. The census tract level represents the 
+      smallest geographical unity that can be presented in a statistically sound manner, given the 
+      datasets that are being used.
+    `,
    description: 'cites the definition and helpful information about census groups',
  },
 });
@ -173,8 +181,8 @@ export const SIDE_PANEL_INITIAL_STATE = defineMessages({
 export const SIDE_PANEL_CBG_INFO = defineMessages({
  CENSUS_BLOCK_GROUP: {
    id: 'areaDetail.geographicInfo.censusBlockGroup',
-    defaultMessage: 'Census block group:',
-    description: 'the census block group id number of the feature selected',
+    defaultMessage: 'Census tract:',
+    description: 'the census tract id number of the feature selected',
  },
  COUNTY: {
    id: 'areaDetail.geographicInfo.county',
@ -304,9 +312,9 @@ export const SIDE_PANEL_INDICATORS = defineMessages({
 export const SIDE_PANEL_INDICATOR_DESCRIPTION = defineMessages({
  AREA_MEDIAN_INCOME: {
    id: 'areaDetail.indicator.description.area_median_income',
-    defaultMessage: 'Median income of the census block group calculated as a percent of the metropolitan'+
+    defaultMessage: 'Median income of the census tract calculated as a percent of the metropolitan'+
        ' area’s or state\'s median income',
-    description: 'Median income of the census block group calculated as a percent of the metropolitan'+
+    description: 'Median income of the census tract calculated as a percent of the metropolitan'+
    ' area’s or state\'s median income',
  },
  EDUCATION: {
@ -316,9 +324,9 @@ export const SIDE_PANEL_INDICATOR_DESCRIPTION = defineMessages({
  },
  POVERTY: {
    id: 'areaDetail.indicator.description.poverty',
-    defaultMessage: 'Percent of a block group\'s population in households where the household income' +
+    defaultMessage: 'Percent of a tract\'s population in households where the household income' +
    ' is at or below 100% of the federal poverty level',
-    description: 'Percent of a block group\'s population in households where the household income' +
+    description: 'Percent of a tract\'s population in households where the household income' +
    ' is at or below 100% of the federal poverty level',
  },
  ASTHMA: {
@ -403,19 +411,23 @@ export const SIDE_PANEL_INDICATOR_DESCRIPTION = defineMessages({
 export const DOWNLOAD_DRAFT = {
  PARAGRAPH_1: <FormattedMessage
    id={'download.draft.ptag.1'}
-    description={'Download the draft list of communities of focus and datasets used.'}
-    defaultMessage={`{downloadDraft} of communities of focus and datasets used. Last updated: {dateUpdated}.`}
+    description={'Download the current list of communities and datasets used.'}
+    defaultMessage={`
+    {downloadDraft} of communities and datasets used (ZIP file will contain one .xlsx, 
+    one .csv, and one .pdf, with a size of {downloadFileSize}). Last updated: {dateUpdated}.
+    `}
    values={{
      downloadDraft:
        <a href={METHODOLOGY_COPY.DOWNLOAD_ZIP_URL}>
-          {`Download the draft list v${METHODOLOGY_COPY.VERSION_NUMBER}`}
+          {`Download the current list`}
        </a>,
      downloadDraftEs:
      <a href={METHODOLOGY_COPY.DOWNLOAD_ZIP_URL}>
-        {'Descargue la lista preliminar'}
+        {`Descargue la lista preliminar`}
      </a>,
      dateUpdated: METHODOLOGY_COPY.DOWNLOAD_LAST_UPDATED,
      dateUpdatedEs: METHODOLOGY_COPY.DOWNLOAD_LAST_UPDATED_ES,
+      downloadFileSize: METHODOLOGY_COPY.DOWNLOAD_FILE_SIZE,
    }}
  />,
  PARAGRAPH_2: <FormattedMessage
@ -436,34 +448,23 @@ export const HOW_YOU_CAN_HELP_LIST_ITEMS = {
  />,
  LIST_ITEM_1: <FormattedMessage
    id={'youCanHelpInfoText.list.item.1'}
-    description={'how one can help us via email'}
-    defaultMessage={`If you have helpful information, we would love to {rxEmailFromYou}.`}
-    values={{
-      rxEmailFromYou:
-      <a href={`mailto:${CONTACT_COPY.FEEDBACK_EMAIL}`}>
-        {'receive an email from you'}
-      </a>,
-    }}
-  />,
-  LIST_ITEM_2: <FormattedMessage
-    id={'youCanHelpInfoText.list.item.2'}
    description={'give us feedback on our data and methodology'}
    defaultMessage={`View our {dataMeth} page and send us feedback.`}
    values={{
      dataMeth:
    <Link to={'/methodology'}>
-      {'Data & methodology'}
+      {'Methodology and data'}
    </Link>,
      dataMethEs:
    <Link to={'/methodology'}>
-      {'Datos y metodología'}
+      {'Metodología y datos'}
    </Link>,
    }}
  />,
-  LIST_ITEM_3: <FormattedMessage
-    id={'youCanHelpInfoText.list.item.3'}
+  LIST_ITEM_2: <FormattedMessage
+    id={'youCanHelpInfoText.list.item.2'}
    description={'share your feedback'}
-    defaultMessage={`Find your community of interest and {shareFeedback}.`}
+    defaultMessage={`Find communities of interest and {shareFeedback}.`}
    values={{
      shareFeedback:
        <a href={`mailto:${CONTACT_COPY.FEEDBACK_EMAIL}`}>
@ -471,5 +472,16 @@ export const HOW_YOU_CAN_HELP_LIST_ITEMS = {
        </a>,
    }}
  />,
+  LIST_ITEM_3: <FormattedMessage
+    id={'youCanHelpInfoText.list.item.3'}
+    description={'share your feedback'}
+    defaultMessage={`Respond to our request for information on {federalRegisterLink}.`}
+    values={{
+      federalRegisterLink:
+        <a href={`https://www.federalregister.gov/`}>
+          {'federalregister.gov'}
+        </a>,
+    }}
+  />,

 };
--- a/client/src/data/copy/methodology.tsx
+++ b/client/src/data/copy/methodology.tsx
@ -24,8 +24,8 @@ export const PAGE = defineMessages({

 // Download Package
 export const DOWNLOAD_FILE_SIZE = '111MB';
-export const DOWNLOAD_LAST_UPDATED = '10/01/21';
-export const DOWNLOAD_LAST_UPDATED_ES = '01/10/21';
+export const DOWNLOAD_LAST_UPDATED = '12/15/21';
+export const DOWNLOAD_LAST_UPDATED_ES = '15/12/21';
 export const VERSION_NUMBER = '0.1';

 export const DOWNLOAD_ZIP_URL = [