Merge branch 'newrelic:develop' into develop

Author: WriteMayur

.gitignore

@@ -91,3 +91,6 @@ src/images/infrastructure_screenshot_full_sonarqube-dashboard.webp
 
 # Local Netlify folder
 .netlify
+
+# Claude Code documentation (local only)
+.claude/

gatsby-browser.js

@@ -1,4 +1,5 @@
 const { updateCookieConsentMessage } = require('./scripts/utils/updateCookieConsentMessage');
+require('katex/dist/katex.min.css');
 
 export { default as onRouteUpdate } from './gatsby/on-route-update';
 

gatsby-config.js

@@ -162,12 +162,10 @@ module.exports = {
         // https://github.com/mdx-js/mdx/issues/1283
         //
         // If this is addressed in MDX v2, we can safely remove this.
-        remarkPlugins: [],
+        remarkPlugins: [require('remark-math')],
         rehypePlugins: [
-          [
-            require('./rehype-plugins/gatsby-inline-images'),
-            { spacing: '0.5rem' },
-          ],
+          require('rehype-katex'),
+          [require('./rehype-plugins/gatsby-inline-images'), { spacing: '0.5rem' }],
         ],
         gatsbyRemarkPlugins: [
           {

package.json

@@ -10,7 +10,7 @@
     "@emotion/styled": "^11.3.0",
     "@mdx-js/mdx": "2.0.0-next.8",
     "@mdx-js/react": "2.0.0-next.8",
-    "@newrelic/gatsby-theme-newrelic": "9.12.4",
+    "@newrelic/gatsby-theme-newrelic": "9.14.0",
     "@splitsoftware/splitio-react": "^1.2.4",
     "ansi-colors": "^4.1.3",
     "cockatiel": "^3.0.0-beta.0",
@@ -41,6 +41,7 @@
     "hast-util-select": "^4.0.2",
     "hast-util-to-mdast": "^7.1.3",
     "jsdom": "^16.5.0",
+    "katex": "^0.16.11",
     "lodash": "^4.17.21",
     "markdown-link-check": "^3.12.2",
     "parse-link-header": "^2.0.0",
@@ -57,9 +58,11 @@
     "react-visibility-sensor": "^5.1.1",
     "rehype-add-classes": "^1.0.0",
     "rehype-format": "^5.0.0",
+    "rehype-katex": "^5.0.0",
     "rehype-parse": "^7.0.1",
     "rehype-remark": "^8.0.0",
     "remark-gfm": "^3.0.1",
+    "remark-math": "^3.0.1",
     "remark-rehype": "^8.0.0",
     "rss": "^1.2.2",
     "sequelize": "^6.21.3",
@@ -228,9 +231,11 @@
     "trigger-i18n-merge": "node scripts/actions/trigger-i18n-merge.js",
     "update-attribute-dictionary-json": "node scripts/actions/update-attribute-dictionary-json.mjs",
     "verify-install-page": "node scripts/verifyInstallPage.js",
+    "mdx:freshness": "node scripts/listMdxFreshness.mjs",
     "verify-mdx": "node scripts/verify_mdx.js",
     "webdriver-desktop": "node scripts/actions/webdriver-desktop.mjs",
-    "webdriver-mobile": "node scripts/actions/webdriver-mobile.mjs"
+    "webdriver-mobile": "node scripts/actions/webdriver-mobile.mjs",
+    "measure-retention": "python3 scripts/measure_content_retention.py"
   },
   "repository": {
     "type": "git",

scripts/actions/utils/handlers.mjs

@@ -427,6 +427,42 @@ export default {
         identifyComponent: false,
       }),
   },
+  p: {
+    deserialize: deserializeComponent,
+    serialize: (state, node) =>
+      serializeComponent(state, node, {
+        tagName: 'p',
+        wrapChildren: false,
+        identifyComponent: false,
+      }),
+  },
+  ul: {
+    deserialize: deserializeComponent,
+    serialize: (state, node) =>
+      serializeComponent(state, node, {
+        tagName: 'ul',
+        wrapChildren: false,
+        identifyComponent: false,
+      }),
+  },
+  ol: {
+    deserialize: deserializeComponent,
+    serialize: (state, node) =>
+      serializeComponent(state, node, {
+        tagName: 'ol',
+        wrapChildren: false,
+        identifyComponent: false,
+      }),
+  },
+  li: {
+    deserialize: deserializeComponent,
+    serialize: (state, node) =>
+      serializeComponent(state, node, {
+        tagName: 'li',
+        wrapChildren: false,
+        identifyComponent: false,
+      }),
+  },
   var: {
     deserialize: (state, node) =>
       deserializeComponent(state, node, { type: 'mdxJsxTextElement' }),

scripts/listMdxFreshness.mjs

@@ -0,0 +1,111 @@
+import { execSync } from 'node:child_process';
+import { writeFileSync } from 'node:fs';
+
+// Add or remove entries here; ALWAYS include trailing slash for directories.
+// Example: 'src/content/docs/experimental/' to exclude that subdir.
+const EXCLUDE_PREFIXES = [
+  'src/content/docs/release-notes/', 
+  'src/content/docs/style-guide/',
+];
+
+function isExcluded(relPath) {
+  return EXCLUDE_PREFIXES.some(pref => relPath.startsWith(pref));
+}
+
+function sh(cmd) {
+  try { return execSync(cmd, { encoding: 'utf8' }).trim(); } catch { return ''; }
+}
+
+function listMdxFiles() {
+  console.log('Collecting tracked MDX files...');
+  const all = sh('git ls-files src/content/docs');
+  const tracked = all ? all.split('\n').filter(f => f.endsWith('.mdx') && !isExcluded(f)) : [];
+  console.log(`Found ${tracked.length} tracked MDX files...`);
+  return tracked;
+}
+
+function lastCommitISO(path) {
+  return sh(`git log -1 --format=%cI -- "${path}"`) || null;
+}
+
+function daysBetween(iso) {
+  const then = Date.parse(iso);
+  const now = Date.now();
+  return (now - then) / (1000 * 60 * 60 * 24);
+}
+
+function monthsBetween(iso) {
+  return daysBetween(iso) / 30;
+}
+
+function main() {
+
+  console.log('Starting MDX tracking scan...');
+  const files = listMdxFiles();
+
+  console.log('Querying last commit for each file...');
+  const rows = [];
+  let processed = 0;
+
+  for (const f of files) {
+    const iso = lastCommitISO(f);
+    processed++;
+    if (processed % 500 === 0) console.log(`Processed ${processed} files...`);
+    if (!iso) continue; // skip if no commit
+    const ageDays = daysBetween(iso);
+    const ageMonths = monthsBetween(iso);
+    rows.push({ path: f, lastCommit: iso, ageDays, ageMonths });
+  }
+  console.log(`Collected commit data for ${rows.length} files`);
+
+  // Sort by age (oldest first)
+  rows.sort((a,b) => b.ageDays - a.ageDays);
+  console.log('Sorted files by age (descending)');
+
+  // Determine age bucket for each row
+  function getAgeBucket(ageMonths) {
+    if (ageMonths >= 24) return '24+ months';
+    if (ageMonths >= 18) return '18-24 months';
+    if (ageMonths >= 12) return '12-18 months';
+    if (ageMonths >= 6) return '6-12 months';
+    return '0-6 months';
+  }
+
+  // Escape CSV field if needed (contains comma, quote, or newline)
+  function escapeCSV(field) {
+    if (field.includes(',') || field.includes('"') || field.includes('\n')) {
+      return `"${field.replace(/"/g, '""')}"`;
+    }
+    return field;
+  }
+
+  // Generate CSV output
+  const csvLines = [];
+  csvLines.push('Path,Last Commit,Age (months),Age (days),Age Bucket');
+
+  for (const r of rows) {
+    const bucket = getAgeBucket(r.ageMonths);
+    const line = [
+      escapeCSV(r.path),
+      r.lastCommit,
+      r.ageMonths.toFixed(1),
+      r.ageDays.toFixed(0),
+      bucket
+    ].join(',');
+    csvLines.push(line);
+  }
+
+  const outputCSV = csvLines.join('\n');
+  const outArg = process.argv.find(a => a.startsWith('--out='));
+  const outPath = outArg ? outArg.split('=')[1] : 'mdx-freshness.csv';
+  try {
+    writeFileSync(outPath, outputCSV, 'utf8');
+    console.log(`Wrote report to ${outPath}`);
+  } catch (e) {
+    console.log('Failed writing file, falling back to stdout');
+    console.log(outputCSV);
+  }
+  console.log('Done');
+}
+
+main();

scripts/measure_content_retention.py

@@ -0,0 +1,95 @@
+import sys
+import subprocess
+import difflib
+
+def run_git_command(command):
+    """A helper function to run a git command and return the output."""
+    try:
+        result = subprocess.run(command, capture_output=True, text=True, check=True, encoding='utf-8')
+        
+        return result.stdout.strip()
+    except subprocess.CalledProcessError as e:
+        print(f"Error executing command '{' '.join(command)}': {e.stderr}")
+        sys.exit(1)
+    except FileNotFoundError:
+        print("Error: 'git' command not found. Is Git installed and in your PATH?")
+        sys.exit(1)
+
+def get_initial_commit(file_path):
+    """Finds the very first commit hash for a given file."""
+    command = ['git', 'log', '--reverse', '--pretty=format:%H', '--', file_path]
+    all_commits = run_git_command(command)
+    if not all_commits:
+        return None
+    initial_commit = all_commits.split('\n')[0]
+    return initial_commit
+
+def get_latest_commit(file_path):
+    """Finds the most recent commit hash for a given file."""
+    command = ['git', 'log', '-1', '--pretty=format:%H', '--', file_path]
+    return run_git_command(command)
+
+def get_file_content(commit_hash, file_path):
+    """Extracts the content of a file from a specific git commit."""
+    command = ['git', 'show', f'{commit_hash}:{file_path}']
+    return run_git_command(command)
+
+def analyze_character_diff(original_text, new_text):
+    """
+    Analyzes character-level differences and returns the percentage of
+    unmodified characters from the original text.
+    """
+    if not original_text:
+        return 0.0, 0.0
+
+    unmodified_chars = 0
+    matcher = difflib.SequenceMatcher(None, original_text, new_text, autojunk=False)
+
+    for tag, i1, i2, j1, j2 in matcher.get_opcodes():
+        if tag == 'equal':
+            unmodified_chars += (i2 - i1)
+
+    total_original_chars = len(original_text)
+    unmodified_percentage = (unmodified_chars / total_original_chars) * 100
+    modified_percentage = 100 - unmodified_percentage
+    
+    return modified_percentage, unmodified_percentage
+
+if __name__ == "__main__":
+    
+    if len(sys.argv) == 2:
+        # Mode 1: Automatic detection
+        file_path = sys.argv[1]
+        print(f"🔎 Automatically finding commits for: {file_path}...")
+        old_commit = get_initial_commit(file_path)
+        new_commit = get_latest_commit(file_path)
+        if not old_commit:
+            print(f"Error: Could not find any commits for '{file_path}'. Does the file exist and is it tracked by Git?")
+            sys.exit(1)
+
+    elif len(sys.argv) == 4:
+        # Mode 2: Manual commit entry
+        file_path = sys.argv[1]
+        old_commit = sys.argv[2]
+        new_commit = sys.argv[3]
+        print(f"✅ Using provided commits for: {file_path}...")
+
+    else:
+        print("Usage (automatic): python diff_chars.py <file_path>")
+        print("Usage (manual):   python diff_chars.py <file_path> <old_commit> <new_commit>")
+        sys.exit(1)
+
+    print(f"   Old commit: {old_commit[:7]}")
+    print(f"   New commit: {new_commit[:7]}")
+    print("--------------------------------------------------")
+
+    original_content = get_file_content(old_commit, file_path)
+    new_content = get_file_content(new_commit, file_path)
+
+    modified_pct, unmodified_pct = analyze_character_diff(original_content, new_content)
+
+    print(f"🔬 Character-level analysis for: {file_path}")
+    print("--------------------------------------------------")
+    print(f"Total characters in original (commit {old_commit[:7]}): {len(original_content)}")
+    print(f"\nPercentage of original characters MODIFIED:   {modified_pct:.2f} %")
+    print(f"Percentage of original characters UNMODIFIED: {unmodified_pct:.2f} %")

src/content/docs/accounts/accounts-billing/account-structure/factors-affecting-access-features-data.mdx

@@ -38,6 +38,10 @@ Your [user type](/docs/accounts/accounts-billing/new-relic-one-user-management/u
 
 To learn more about assigned roles, see [How groups and roles control access to New Relic](/docs/accounts/accounts-billing/new-relic-one-user-management/user-management-concepts/#understand-concepts).
 
+### Organization-level feature controls [#feature-controls]
+
+Your organization administrators can control access to Intelligent Observability features using the [Feature control manager](/docs/accounts/accounts-billing/new-relic-one-user-management/feature-control-manager). If a feature appears unavailable, check with your admin about whether it's been activated for your account.
+
 ### Pricing edition [#pricing]
 
 We have four pricing editions: Free, Standard, Pro, and Enterprise. Your edition affects your access to some features. For more on this, see [Editions](https://newrelic.com/pricing).

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

@@ -39,6 +39,7 @@ Here are some of the most popular topics related to New Relic administration:
 
 * [Manage billing](/docs/accounts/accounts-billing/new-relic-one-pricing-billing/new-relic-one-pricing-billing#usage-ui)
 * [Manage users](/docs/accounts/accounts-billing/new-relic-one-user-management/introduction-managing-users)
+* [Manage Intelligent Observability features](/docs/accounts/accounts-billing/new-relic-one-user-management/feature-control-manager)
 * [Add an account to your organization](/docs/accounts/accounts-billing/account-structure/add-accounts)
 * [Manage data](/docs/data-apis/manage-data/manage-your-data)
 * [Manage API keys](/docs/apis/intro-apis/new-relic-api-keys)

src/content/docs/accounts/accounts-billing/new-relic-one-pricing-billing/compute-budgets/overview.mdx

@@ -32,14 +32,12 @@ Compute Budgets provides a mechanism to monitor and alert on your Compute Consum
 
 To use **Compute Budgets**, you must:
 
-- [Sign up](https://newrelic.com/signup/) for a New Relic account.
-- Be on at least one compute SKU and have a single organisation, non-POA structure.
-- Have a minimum commitment amount defined on the Compute SKU.
+  - [Sign up](https://newrelic.com/signup/) for a New Relic account.
+  - Be a single-tenant customer with a contract commitment on either Core or Legacy Compute Capacity Units (CCUs).
+  - Have a minimum commitment amount defined on the Compute SKU.
 
 ## Access controls
 
-- Users with the `organization_manager` role can **create**, **update**, or **delete** `Org Budget` and `account budgets`, provided they also have access to the telemetry account.
-
-- Users with the `organization_read_only` role can **view** `Org Budget` and `account budgets`, provided they also have access to the telemetry account.
-
-- Users who don't have access to the telemetry account cannot view the `Org budget`, but they can view `account budgets`, if they do have access to them.
+  - Users with the `organization_manager` role can **create**, **update**, or **delete** `Org Budget` and `account budgets`, provided they also have access to the telemetry account.
+  - Users with the `organization_read_only` role can **view** `Org Budget` and `account budgets`, provided they also have access to the telemetry account.
+  - Users who don't have access to the telemetry account cannot view the `Org budget`, but they can view `account budgets`, if they do have access to them.