stale-md

Find stale documentation through CI.

stale-md is a CircleCI orb that identifies stale documentation (ie 90 days of unchanged .md file) and warns developers on maintaining their documentation.

Usage

version: 2.1

orbs:
  stale-md: mkotsollaris/stale-md@0.0.3
  orb-tools: circleci/orb-tools@11.1

jobs:
  scan:
    docker:
      - image: cimg/base:current
    steps:
      - checkout
      - stale-md/scan

workflows:
  main:
    jobs:
      - scan

Options

parameters:
  IGNORED_FILES:
    type: string
    default: "./.github/PULL_REQUEST_TEMPLATE/PULL_REQUEST.md"
    description: "files to be ignored (space-separated)"
  DAYS_THRESHOLD:
    type: string
    default: "90"
    description: "Time threshold in days"

Example here.

Motivation

Inspired by Software Engineering at Google, where there was a reference that Google runs a similar pattern internally to embrace continuous software engineering developments and constantly update their documentation.

By utilizing this orb command, developers are reminded that while their software updates so does their documentation. This orb aims to treat documentation as a first-class citizen, similar to production level code where documentation is always remaining up to date.

Resources

• Documentation - "Software Engineering at Google" Chapter Review

License

MIT