Merge pull request #470 from GSA/jrc_ai-guidance

Added AI content for OMB review and eventual release.

src/components/federal-agencies/__snapshots__/about-page.test.js.snap

@@ -81,6 +81,9 @@ exports[`components - AboutPage - InventoryCode render should render correctly 1
     schema={Object {}}
     url="/assets/data/schema.json"
   />
+  <LazyHTML
+    url="/src/components/federal-agencies/html/compliance/data-assets-ai.html"
+  />
   <div
     id="how-to-inventory-b"
   >

src/components/federal-agencies/html/compliance/data-assets-ai.html

@@ -0,0 +1,138 @@
+<div id="data-assets-ai-wrapper">
+  <h2 id="data-assets-ai">Source Code Considerations for AI R&D Models</h2>
+  <p>
+    Consistent with the
+    <a
+      href="https://www.whitehouse.gov/presidential-actions/executive-order-maintaining-american-leadership-artificial-intelligence/"
+      title="link to AI executive order"
+      >Executive Order on Maintaining American Leadership in Artificial Intelligence (EO 13859)</a
+    >, agencies are directed to improve source code inventory documentation (i.e., agency code.json)
+    to enable discovery and usability of source code AI models.
+  </p>
+  <table class="usa-table">
+    <thead>
+      <tr>
+        <th scope="col">Field Name</th>
+        <th scope="col">Tags</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr>
+        <th scope="row">Data Type</th>
+        <td>Array</td>
+      </tr>
+      <tr>
+        <th scope="row">Definition</th>
+        <td>
+          An array of keywords that will be helpful in discovering and searching for the release.
+        </td>
+      </tr>
+      <tr>
+        <th scope="row">Required</th>
+        <td>Always</td>
+      </tr>
+      <tr>
+        <th scope="row"><span style="white-space: nowrap;">AI R&D Guidance</span></th>
+        <td>
+          Agencies shall include the keyword of <code>usg-artificial-intelligence</code> for all
+          source code determined to support AI R&D. Other keywords can be developed and used as
+          appropriate and coordinated with standard data tagging available on
+          <a href="https://resources.data.gov/">resources.data.gov</a>.
+        </td>
+      </tr>
+    </tbody>
+  </table>
+  <table class="usa-table">
+    <thead>
+      <tr>
+        <th scope="col">Field Name</th>
+        <th scope="col">Contact</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr>
+        <th scope="row">Data Type</th>
+        <td>Object</td>
+      </tr>
+      <tr>
+        <th scope="row">Definition</th>
+        <td>Point of contact information for the release.</td>
+      </tr>
+      <tr>
+        <th scope="row">Required</th>
+        <td>Always</td>
+      </tr>
+      <tr>
+        <th scope="row"><span style="white-space: nowrap;">AI R&D Guidance</span></th>
+        <td>
+          Be sure to identify and include domain experts and their contact information who can
+          discuss the model with interested AI researchers. If not the same as the domain expert,
+          Agencies shall also identify an expert and their contact information who can discuss
+          restrictions or controls on the model.
+        </td>
+      </tr>
+    </tbody>
+  </table>
+  <table class="usa-table">
+    <thead>
+      <tr>
+        <th scope="col">Field Name</th>
+        <th scope="col">exemptionText</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr>
+        <th scope="row">Data Type</th>
+        <td>String or Null</td>
+      </tr>
+      <tr>
+        <th scope="row">Definition</th>
+        <td>
+          If an exemption is listed in the <code>usageType</code> field, this field should include a
+          one or two sentence justification for the exemption used.
+        </td>
+      </tr>
+      <tr>
+        <th scope="row">Required</th>
+        <td>No</td>
+      </tr>
+      <tr>
+        <th scope="row"><span style="white-space: nowrap;">AI R&D Guidance</span></th>
+        <td>
+          Agencies shall describe how researchers may be able to access
+          <code>governmentWideReuse</code> or exempt data.
+        </td>
+      </tr>
+    </tbody>
+  </table>
+  <table class="usa-table">
+    <thead>
+      <tr>
+        <th scope="col">Field Name</th>
+        <th scope="col">relatedCode</th>
+      </tr>
+    </thead>
+    <tbody>
+      <tr>
+        <th scope="row">Data Type</th>
+        <td>Array</td>
+      </tr>
+      <tr>
+        <th scope="row">Definition</th>
+        <td>
+          An array of affiliated government repositories that may be a part of the same project. For
+          example, <code>relatedCode</code> for <code>code-gov-front-end</code> would include
+          <code>code-gov-api</code> and <code>code-gov-client</code>.
+        </td>
+      </tr>
+      <tr>
+        <th scope="row">Required</th>
+        <td>No</td>
+      </tr>
+      <tr>
+        <th scope="row"><span style="white-space: nowrap;">AI R&D Guidance</span></th>
+        <td>Agencies shall describe related models and code.</td>
+      </tr>
+    </tbody>
+  </table>
+</div>

src/components/federal-agencies/inventory-code/inventory-code.container.js

@@ -31,6 +31,7 @@ class InventoryCodeContainer extends Component {
           <LazyHTML url={`${dataurl}compliance/how-to-inventory-a.html`} />
         </div>
         <InventoryCodeComponent url={schemaUrl} schema={schema} />
+        <LazyHTML url={`${dataurl}compliance/data-assets-ai.html`} />
         <div id="how-to-inventory-b">
           <LazyHTML url={`${dataurl}compliance/how-to-inventory-b.html`} />
         </div>

styles/theme/_uswds-theme-custom-styles.scss

@@ -137,3 +137,6 @@ html {
     }
   }
 }
+code {
+  background-color: rgba(0, 0, 0, 0.05);
+}