remoteintech/remote-jobs · warning

The "Company blurb" section is empty. Please add a descripti

Error message

The "Company blurb" section is empty. Please add a description of the company.

What it means

Warning at lines 179-187. After the required-section check, a regex captures the body between `## Company blurb` and the next `##` heading (or end of file). If the captured group trims to empty, a WARNING (not an error) is pushed. Warnings increment results.summary.warnings but do not cause exit 1, so they don't block the PR — they're advisory.

Source

Thrown at .github/scripts/validate-companies.js:185

  // Check required markdown sections
  const bodyContent = content.replace(/^---[\s\S]*?---/, "");
  for (const section of REQUIRED_SECTIONS) {
    const sectionPattern = new RegExp(
      `^##\\s+${escapeRegExp(section)}\\s*$`,
      "m"
    );
    if (!sectionPattern.test(bodyContent)) {
      errors.push(`Missing required section: "## ${section}"`);
    }
  }

  // Check that "Company blurb" has content (not just the heading)
  const blurbMatch = bodyContent.match(
    /^##\s+Company blurb\s*\n([\s\S]*?)(?=^##\s|\s*$)/m
  );
  if (blurbMatch && !blurbMatch[1].trim()) {
    warnings.push(
      'The "Company blurb" section is empty. Please add a description of the company.'
    );
  }

  return { errors, warnings };
}

function isValidUrl(str) {
  try {
    const url = new URL(str);
    return url.protocol === "https:" || url.protocol === "http:";
  } catch {
    return false;
  }
}

function escapeRegExp(str) {
  return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
}

View on GitHub (pinned to b1dd8deb19)

Solutions

1. Write at least one descriptive sentence under `## Company blurb`.
2. Re-run the validator and confirm the warning clears (exit code stays 0 if no errors).

Example fix

// before
## Company blurb


## Remote status
// after
## Company blurb

Acme builds developer tools used by teams worldwide.

## Remote status

function blurbHasContent(body) {
  const m = body.match(/^##\s+Company blurb\s*\n([\s\S]*?)(?=^##\s|\s*$)/m);
  return m ? m[1].trim().length > 0 : false;
}

function hasNonEmptyBlurb(body) {
  const m = body.match(/^##\s+Company blurb\s*\n([\s\S]*?)(?=^##\s|\s*$)/m);
  return !!m && m[1].trim().length > 0;
}

When it happens

Trigger: The `## Company blurb` heading is present but the contributor forgot to write the paragraph; only blank lines or whitespace follow the heading; the body was deleted in a merge leaving the heading orphaned.

Common situations: Contributor adds the heading as a placeholder intending to fill it later; markdown editor collapses empty paragraphs; copy-paste from a template that included only headings.

Related errors

• Missing required section: "## ${section}"

AI-assisted analysis of remoteintech/remote-jobs@b1dd8deb19 (2026-08-13). Data as JSON: /api/errors/ef6cf8e096201b59. Report an issue: GitHub.