github-docs.js

const githubDocsConfig = {
  'link-punctuation': {
    // GHD001
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'internal-links-no-lang': {
    // GHD002
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'internal-links-slash': {
    // GHD003
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'image-file-kebab-case': {
    // GHD004
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'hardcoded-data-variable': {
    // GHD005
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'internal-links-old-version': {
    // GHD006
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'code-annotations': {
    // GHD007
    severity: 'error',
    'partial-markdown-files': false,
    'yml-files': false,
  },
  'early-access-references': {
    // GHD008
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'github-owned-action-references': {
    // GHD013
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'liquid-data-references-defined': {
    // GHD014
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'liquid-data-tag-format': {
    // GHD015
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'liquid-quoted-conditional-arg': {
    // GHD016
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'liquid-syntax': {
    // GHD018
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'liquid-if-tags': {
    // GHD019
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'liquid-ifversion-tags': {
    // GHD020
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'liquid-ifversion-versions': {
    // GHD022
    severity: 'warning',
    'partial-markdown-files': true,
  },
  'yaml-scheduled-jobs': {
    // GHD021
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'image-alt-text-exclude-words': {
    // GHD031
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'image-alt-text-end-punctuation': {
    // GHD032
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'incorrect-alt-text-length': {
    // GHD033
    severity: 'warning',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'list-first-word-capitalization': {
    // GHD034
    severity: 'warning',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'rai-reusable-usage': {
    // GHD035
    severity: 'error',
    'partial-markdown-files': true,
  },
  'image-no-gif': {
    // GHD036
    severity: 'error',
    'partial-markdown-files': true,
  },
  'expired-content': {
    // GHD038
    severity: 'error',
    'partial-markdown-files': true,
  },
  'expiring-soon': {
    // GHD039
    severity: 'warning',
    'partial-markdown-files': true,
  },
  'table-liquid-versioning': {
    // GH040
    severity: 'error',
    'partial-markdown-files': true,
  },
  'third-party-action-pinning': {
    // GH041
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'liquid-tag-whitespace': {
    // GHD042
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'link-quotation': {
    // GHD043
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
}

export const githubDocsFrontmatterConfig = {
  'frontmatter-early-access-references': {
    // GHD009
    severity: 'error',
    'partial-markdown-files': false,
    'yml-files': false,
  },
  'frontmatter-hidden-docs': {
    // GHD010
    severity: 'error',
    'partial-markdown-files': false,
    'yml-files': false,
  },
  'frontmatter-video-transcripts': {
    // GHD011
    severity: 'error',
    'partial-markdown-files': false,
    'yml-files': false,
  },
  'frontmatter-schema': {
    // GHD012
    severity: 'error',
    'partial-markdown-files': false,
    'yml-files': false,
  },
  'frontmatter-liquid-syntax': {
    // GHD017
    severity: 'error',
    'partial-markdown-files': false,
    'yml-files': false,
  },
  'liquid-ifversion-tags': {
    // GHD020
    severity: 'error',
    'partial-markdown-files': false,
  },
  'liquid-ifversion-versions': {
    // GHD022
    severity: 'warning',
    'partial-markdown-files': false,
  },
  'link-quotation': {
    // GHD043
    severity: 'error',
    'partial-markdown-files': false,
  },
}

// Configures rules from the `github/markdownlint-github` repo
// created by the accessibility team.
const githubMarkdownlintConfig = {
  'no-default-alt-text': {
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
  'no-generic-link-text': {
    severity: 'error',
    'partial-markdown-files': true,
    'yml-files': true,
  },
}

// Configures rules from the open-source Markdownlint extension
// search-replace:
// https://www.npmjs.com/package/markdownlint-rule-search-replace
export const searchReplaceConfig = {
  'search-replace': {
    rules: [
      {
        name: 'todocs-placeholder',
        message: 'Catch occurrences of TODOCS placeholder.',
        searchPattern: '/todocs/gi',
        searchScope: 'all',
        severity: 'error',
        precommitSeverity: 'warning',
        'partial-markdown-files': true,
        'yml-files': true,
      },
      {
        name: 'docs-domain',
        message: 'Catch occurrences of docs.github.com domain.',
        search: 'docs.github.com',
        searchScope: 'all',
        severity: 'error',
        'partial-markdown-files': true,
        'yml-files': true,
      },
      {
        name: 'help-domain',
        message: 'Catch occurrences of help.github.com domain.',
        search: 'help.github.com',
        searchScope: 'all',
        severity: 'error',
        'partial-markdown-files': true,
        'yml-files': true,
      },
      {
        name: 'developer-domain',
        message: 'Catch occurrences of developer.github.com domain.',
        // Do not match developer.github.com/changes or
        // developer.github.com/enterprise/[0-9] or
        // developer.github.com/enterprise/{{something}} (e.g. liquid).
        // There are occurrences that will likely always remain in the content.
        searchPattern: '/developer\\.github\\.com(?!\\/(changes|enterprise\\/([0-9]|{))).*/g',
        searchScope: 'all',
        severity: 'error',
        'partial-markdown-files': true,
        'yml-files': true,
      },
      {
        // Catches usage of old liquid data reusable syntax. For example:
        // {{ site.data.variables.product_releases }}
        name: 'deprecated liquid syntax: site.data',
        message: 'Catch occurrences of deprecated liquid data syntax.',
        searchPattern: '/{{\\s*?site\\.data\\.([a-zA-Z0-9-_]+(?:\\.[a-zA-Z0-9-_]+)+)\\s*?}}/g',
        replace: '{% data $1 %}',
        severity: 'error',
        'partial-markdown-files': true,
        'yml-files': true,
      },
      {
        // Catches usage of old octicon variable syntax. For example:
        // - {{ octicon-plus }}
        // - {{ octicon-plus An example label }}
        name: 'deprecated liquid syntax: octicon-<icon-name>',
        message:
          'The octicon liquid syntax used is deprecated. Use this format instead `octicon "<octicon-name>" aria-label="<Octicon aria label>"`',
        searchPattern: '/{{\\s*?octicon-([a-z-]+)(\\s[\\w\\s\\d-]+)?\\s*?}}/g',
        severity: 'error',
        'partial-markdown-files': true,
        'yml-files': true,
      },
    ],
  },
}

export const customConfig = {
  ...searchReplaceConfig,
  ...githubDocsConfig,
  ...githubMarkdownlintConfig,
  ...githubDocsFrontmatterConfig,
}