Merge branch 'develop' into pm-handbook

.github/stale.yml

@@ -1,7 +1,7 @@
 # Number of days of inactivity before an issue becomes stale
-daysUntilStale: 30
+daysUntilStale: 90
 # Number of days of inactivity before a stale issue is closed
-daysUntilClose: 10
+daysUntilClose: 15
 # Issues with these labels will never be considered stale
 exemptLabels:
   - security

gatsby-config.js

@@ -131,14 +131,21 @@ module.exports = {
               return {
                 q: tags ? tags.map(quote).join(' OR ') : title,
                 search_fields: {
-                  page: ['tags^10', 'body^5', 'title^1.5', '*'],
+                  page: [
+                    'tags^10',
+                    'quick_start_name^8',
+                    'body^5',
+                    'title^1.5',
+                    '*',
+                  ],
                 },
                 filters: {
                   page: {
                     type: [
                       `docs${postfix}`,
                       `developer${postfix}`,
                       `opensource${postfix}`,
+                      `quick_starts${postfix}`,
                     ],
                     document_type: [
                       '!views_page_menu',
@@ -488,17 +495,19 @@ module.exports = {
                 releaseDate(fromNow: false)
                 version
               }
+              excerpt(pruneLength: 5000)
             }
           }
         }
         `,
         path: '/api/agent-release-notes.json',
         serialize: ({ data }) =>
           data.allMdx.nodes
-            .map(({ frontmatter }) => ({
+            .map(({ frontmatter, excerpt }) => ({
               agent: getAgentName(frontmatter.subject),
               date: frontmatter.releaseDate,
               version: frontmatter.version,
+              description: excerpt,
             }))
             .filter(({ date, agent }) => Boolean(date && agent)),
       },

package.json

@@ -9,7 +9,7 @@
     "@github-docs/frontmatter": "^1.3.1",
     "@mdx-js/mdx": "^2.0.0-next.8",
     "@mdx-js/react": "^2.0.0-next.8",
-    "@newrelic/gatsby-theme-newrelic": "^2.5.0",
+    "@newrelic/gatsby-theme-newrelic": "^2.5.2",
     "@splitsoftware/splitio-react": "^1.2.4",
     "babel-jest": "^26.3.0",
     "common-tags": "^1.8.0",
@@ -20,7 +20,7 @@
     "gatsby-plugin-gatsby-cloud": "^2.8.1",
     "gatsby-plugin-json-output": "^1.2.0",
     "gatsby-plugin-manifest": "^3.8.0",
-    "gatsby-plugin-mdx": "^2.8.0",
+    "gatsby-plugin-mdx": "^2.13.0",
     "gatsby-plugin-meta-redirect": "^1.1.1",
     "gatsby-plugin-offline": "^4.8.0",
     "gatsby-plugin-react-helmet": "^4.8.0",
@@ -41,8 +41,8 @@
     "hast-util-select": "^4.0.2",
     "hast-util-to-mdast": "^7.1.3",
     "jest": "^26.6.3",
-    "jest-when": "^3.3.1",
     "jest-emotion": "^10.0.32",
+    "jest-when": "^3.3.1",
     "jsdom": "^16.5.0",
     "lodash": "^4.17.21",
     "parse-link-header": "^1.0.1",
@@ -151,7 +151,8 @@
     "postinstall": "patch-package",
     "extract-i18n": "i18next",
     "get-translated-files": "node scripts/actions/add-files-to-translation-queue.js",
-    "check-for-outdated-translations": "node scripts/actions/check-for-outdated-translations.js"
+    "check-for-outdated-translations": "node scripts/actions/check-for-outdated-translations.js",
+    "verify-mdx": "node scripts/verify_mdx.js"
   },
   "husky": {
     "hooks": {

scripts/actions/utils/related-resources-helpers.js

@@ -23,6 +23,10 @@ const stripTrailingSlash = (url) => {
 exports.quote = (str) => `"${str}"`;
 
 exports.uniq = (arr) => [...new Set(arr)];
+const appendLeadingSlash = (url) =>
+  url.startsWith('/') || url.startsWith('!') || url.startsWith('https://')
+    ? url
+    : `/${url}`;
 
 exports.getExcludedUrls = (frontmatter, siteUrl) => {
   const resources = frontmatter.resources || [];
@@ -31,6 +35,7 @@ exports.getExcludedUrls = (frontmatter, siteUrl) => {
   return resources
     .map((resource) => resource.url)
     .concat(redirects)
+    .map(appendLeadingSlash)
     .map((url) => (url.startsWith('/') ? siteUrl + url : url));
 };
 

scripts/verify_mdx.js

@@ -0,0 +1,33 @@
+const mdx = require('@mdx-js/mdx');
+const fs = require('fs');
+const glob = require('glob');
+
+const readFile = async (filePath) => {
+  try {
+    console.log(`reading ${filePath}`);
+    const mdxText = fs.readFileSync(filePath, 'utf8');
+    const jsx = mdx.sync(mdxText);
+  } catch (exception) {
+    console.log(JSON.stringify(exception, null, 4));
+    return filePath;
+  }
+};
+
+const main = async () => {
+  let filePaths = process.argv.slice(2);
+
+  if (filePaths.length === 0) {
+    // if user did not supply paths, default to all
+    filePaths = glob.sync(
+      `${__dirname}/../src{/content/**/*.mdx,/i18n/content/**/*.mdx}`
+    );
+  }
+
+  const allResults = await Promise.all(filePaths.map(readFile));
+  const results = allResults.filter(Boolean);
+
+  console.log(results);
+  console.log(`Failed file count: ${results.length}`);
+};
+
+main();

src/components/SEO.js

@@ -10,6 +10,23 @@ const METADATA = [
   },
 ];
 
+const crazyEgg = (location) => {
+  const { pathname } = location;
+  const homepage = '/';
+  const signup =
+    '/docs/accounts/accounts-billing/account-setup/create-your-new-relic-account/';
+
+  if (pathname === homepage || pathname === signup) {
+    return (
+      <script
+        type="text/javascript"
+        src="//script.crazyegg.com/pages/scripts/0045/9836.js"
+        async="async"
+      />
+    );
+  }
+};
+
 const DocsSiteSeo = ({
   location,
   title,
@@ -55,6 +72,8 @@ const DocsSiteSeo = ({
     {(description || title) && (
       <meta name="description" content={description || title} />
     )}
+
+    {crazyEgg(location)}
   </SEO>
 );
 

src/content/docs/accounts-partnerships/accounts/saml-single-sign/configure-saml-multiple-accounts.mdx

@@ -7,12 +7,7 @@ tags:
 metaDescription: 'For New Relic, how to set up SAML single sign-on (SSO) for multiple accounts.'
 redirects:
   - /docs/subscriptions/configuring-saml-with-multiple-accounts
-  - >-
-    /docs/accounts-partnerships/accounts/saml-single-sign/configuring-saml-multiple-accounts
-watermark: |-
-  Original
-  user
-  model
+  - /docs/accounts-partnerships/accounts/saml-single-sign/configuring-saml-multiple-accounts
 ---
 
 <Callout variant="important">

src/content/docs/accounts/accounts-billing/account-setup/create-your-new-relic-account.mdx

@@ -1,12 +1,8 @@
 ---
-title: Create a New Relic account
-tags:
-  - Accounts
-  - Accounts and billing
-  - Account setup
+title: Sign up for New Relic 
 translate:
   - jp
-metaDescription: How to sign up for a free forever New Relic account.
+metaDescription: Sign up for a free forever New Relic account.
 redirects:
   - /docs/subscriptions/getting-started-with-your-new-relic-account
   - /docs/subscriptions/creating-your-new-relic-account
@@ -17,19 +13,45 @@ redirects:
   - /docs/accounts/install-new-relic/account-setup/create-your-new-relic-account
 ---
 
-To create a new New Relic organization, go to [newrelic.com/signup](https://newrelic.com/signup). A New Relic organization gives you free access to our entire [observability platform](https://newrelic.com/platform).
+At New Relic, our mission is to help you create more perfect software. So we give you **free access** to our observability platform, **forever**. Our [free tier](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing/#free) lets you ingest up to 100 GBs per month, and have one [full user](/docs/accounts/accounts-billing/new-relic-one-user-management/new-relic-one-user-model-understand-user-structure/#user-type) and **unlimited** basic users.
 
-If you want to add accounts to an existing organization, see [Organization structure](/docs/accounts/accounts-billing/account-structure/new-relic-account-structure).
+Ready to get started? 
 
-## Sign up [#sign-up]
+<ButtonGroup> <ButtonLink
+  role="button"
+  to="https://newrelic.com/signup"
+  variant="primary"
+>
+  Sign up for New Relic
+</ButtonLink>
+</ButtonGroup>
 
-When you sign up for a New Relic organization, you have access to New Relic for free and forever. Sign up in a few minutes at [newrelic.com/signup](http://newrelic.com/signup). Or, if you have a specific offer from a [New Relic partner](/docs/accounts-partnerships/partnerships/partner-based-installation/log-install-new-relic-partners), use the link they've sent you.
+Want to learn more first? 
 
-Next steps after signing up:
+As just one example of what you can do with New Relic, imagine you are a Kubernetes administrator overseeing many clusters and pods of software containers. Where do you start troubleshooting? This short video shows how you can locate a problem cluster and use distributed tracing to find relevant logs:
 
-* To learn more about how to optimize your use of New Relic, see [Introduction to New Relic](https://docs.newrelic.com/docs/using-new-relic/welcome-new-relic/get-started/introduction-new-relic#get-started-now).
-* To learn about our monitoring solutions, browse [our integrations](https://newrelic.com/integrations).
-* To watch videos on how to use our features, see [New Relic University](https://learn.newrelic.com/).
+<Video
+  type="wistia"
+  id="hytv3kad74"
+/>
+
+Learn more: 
+* [See pricing details](https://newrelic.com/pricing)
+* [Learn what New Relic does](https://docs.newrelic.com/docs/using-new-relic/welcome-new-relic/get-started/introduction-new-relic#get-started-now)
+* [Browse our solutions](https://newrelic.com/integrations)
+
+### Next steps [#next-steps]
+
+Here are some next steps after signing up: 
+
+* Start reporting data using our [**Add your data** UI](https://one.newrelic.com/launcher/nr1-core.settings) 
+* [Get ideas on how to bring all your data together](/docs/using-new-relic/welcome-new-relic/get-started/introduction-new-relic/#bring-your-data)
+* [Watch New Relic University videos](https://learn.newrelic.com/)
+* If you unintentionally signed up, see [Delete account](/docs/accounts/accounts-billing/account-setup/downgradecancel-account/#cancel-simple-org)
+
+## Add accounts to an existing New Relic organization [#existing]
+
+If you already have an existing New Relic organization and want to add accounts to it, see [Account structure](/docs/accounts/accounts-billing/account-structure/new-relic-account-structure).
 
 ## Login problems? [#troubleshooting]
 

src/content/docs/accounts/accounts-billing/account-setup/troubleshoot-new-relics-password-email-address-login-problems.mdx

@@ -161,7 +161,7 @@ Some general system problems and solutions:
   >
     If your organization uses a SAML Single Sign On (SSO) solution, you can skip the **Password** field when you log in. If you need to reset your password, contact your organization's system administrator or IT department as applicable.
 
-    If you're an administrator who has recently enabled or made changes to your SAML SSO settings and are unable to log in, there might be an issue with your configuration. Customers on the [New Relic One user model](https://docs.newrelic.com/docs/accounts/accounts-billing/new-relic-one-user-management/new-relic-one-user-model-understand-user-structure) can use a special recovery flow to fix any issues. Visit [login.newrelic.com/recovery_access](http://login.newrelic.com/recovery_access) to bypass SSO and gain one-time access to your organization.
+    If you're an administrator who has recently enabled or made changes to your SAML SSO settings and are unable to log in, there might be an issue with your configuration. Customers on the [New Relic One user model](/docs/accounts/accounts-billing/new-relic-one-user-management/new-relic-one-user-model-understand-user-structure) can use a special recovery flow to fix any issues. Visit [login.newrelic.com/recovery_access](http://login.newrelic.com/recovery_access) to bypass SSO and gain one-time access to your organization.
   </Collapser>
 
   <Collapser

src/content/docs/accounts/accounts-billing/account-structure/account-id.mdx

@@ -19,7 +19,7 @@ Some New Relic procedures require use of your account ID (for example, some API
 Options for finding your account ID:
 
 * If your organization has multiple accounts: From [one.newrelic.com](https://one.newrelic.com), use the account selector dropdown near the top of the page to switch between accounts and see their IDs.
-* There are other options, depending on which [account/user model](/docs/accounts/original-accounts-billing/original-product-based-pricing/overview-changes-pricing-user-model/#user-models) you're on: 
+* There are other options, depending on which [user model](/docs/accounts/original-accounts-billing/original-product-based-pricing/overview-changes-pricing-user-model/#user-models) you're on: 
   * New Relic One user model: Click the [account dropdown](/docs/using-new-relic/welcome-new-relic/get-started/glossary#account-dropdown) and then click **Administration**. Click **Organization and access** and then **Accounts** to see account IDs.
   * Original user model: Click the [account dropdown](/docs/using-new-relic/welcome-new-relic/get-started/glossary#account-dropdown), click **Account settings**, and then click **API keys**. The account ID is displayed there.
 

src/content/docs/accounts/accounts-billing/account-structure/add-accounts.mdx

@@ -5,7 +5,7 @@ translate:
 metaDescription: How to add accounts to your New Relic organization. 
 ---
 
-How you add accounts to your New Relic organization depends on the type of [account/user model](/docs/accounts/original-accounts-billing/original-product-based-pricing/overview-changes-pricing-user-model/#user-models) your users are on: 
+How you add accounts to your New Relic organization depends on the type of [user model](/docs/accounts/original-accounts-billing/original-product-based-pricing/overview-changes-pricing-user-model/#user-models) your users are on: 
 
 * New Relic One user model: if you're on our newer user model, you currently can't add accounts using the UI but must talk to your account representative. For more information, see [Organization structure](/docs/accounts/accounts-billing/account-structure/new-relic-account-structure). 
 * Original user model: you can add accounts via the UI. For more information, see [Add accounts](/docs/accounts/original-accounts-billing/original-users-roles/parent-child-account-structure/#creating). 

src/content/docs/accounts/accounts-billing/account-structure/new-relic-account-structure.mdx

@@ -9,19 +9,19 @@ redirects:
   - /docs/accounts/accounts-billing/new-relic-one-pricing-users/new-relic-account-structure
 ---
 
-Depending on your account/user model, you have different options for adding and managing accounts and assigning users to them. We have two models: 
+Depending on your user model, you have different options for adding and managing accounts and assigning users to them. We have two models: 
 
-* [New Relic One account/user model](#new-model)
-* [Original account/user model](/docs/accounts/original-accounts-billing/original-users-roles/original-account-structure)
+* [New Relic One user model](#new-model)
+* [Original user model](/docs/accounts/original-accounts-billing/original-users-roles/original-account-structure)
 
 <Callout variant="important">
-Note that the account/user model is not directly related to our [two pricing plans](/docs/accounts/original-accounts-billing/original-product-based-pricing/overview-changes-pricing-user-model/#pricing-plans). 
+Note that the user model is not directly related to our [two pricing plans](/docs/accounts/original-accounts-billing/original-product-based-pricing/overview-changes-pricing-user-model/#pricing-plans). 
 </Callout>
 
-## New Relic One account/user model [#new-model]
+## New Relic One user model [#new-model]
 
 <Callout variant="important">
-This section is about organizations on the New Relic One account/user model, not the original model. [Learn more about the difference.](/docs/accounts/original-accounts-billing/original-product-based-pricing/overview-changes-pricing-user-model/#user-models) 
+This section is about organizations on the New Relic One user model, not the original model. [Learn more about the difference.](/docs/accounts/original-accounts-billing/original-product-based-pricing/overview-changes-pricing-user-model/#user-models) 
 </Callout>
 
 At New Relic, an "organization" represents a New Relic customer. The organization contains everything relevant to a New Relic customer: its accounts, its users, and its data. 
@@ -38,6 +38,6 @@ Note that some features, like dashboards and workloads, can display data from ac
 
 To learn more about access issues, see [Factors affecting access](/docs/accounts/accounts-billing/account-structure/factors-affecting-access-features-data/). 
 
-## Original account/user model [#original-model]
+## Original user model [#original-model]
 
-See [Original account/user model structure](/docs/accounts/original-accounts-billing/original-users-roles/original-account-structure).
+See [Original user model structure](/docs/accounts/original-accounts-billing/original-users-roles/original-account-structure).

src/content/docs/accounts/accounts-billing/general-account-settings/introduction-account-settings.mdx

@@ -19,7 +19,8 @@ To find billing-related UI, go to [one.newrelic.com](https://one.newrelic.com) a
 
 * **Manage your plan**: Options for viewing and managing billing-related settings. 
 * **Manage your data**: Options for managing ingest of data, which can be a billing factor. 
-* **Administration**: Options related to billing, usage, and [user management](#manage-users) (this UI available only to users on our [New Relic One user model](/docs/accounts/original-accounts-billing/original-product-based-pricing/overview-changes-pricing-user-model/#user-models)). 
+* **View your usage**: View of your billing-related usage. 
+* **Administration**: Options related to billing, usage, and [user management](#manage-users) (this UI available only for users on our [New Relic One user model](/docs/accounts/original-accounts-billing/original-product-based-pricing/overview-changes-pricing-user-model/#user-models)). 
 * **Account settings**: Options related to subscription and usage, and [user management](#manage-users) (this UI available only to users on our [original user model](/docs/accounts/original-accounts-billing/original-product-based-pricing/overview-changes-pricing-user-model/#user-models)).
 
 Pricing-related topics: