Skip to content

jules2689/adr-actions

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 

Repository files navigation

ADR Action

Action to generate Architecture Decision Records Table of Contents and ADR Graph dependency into a README.md in the ADR dir.

This action also does some basic linting to:

  • Ensure no duplicate numbering of ADRs
  • ADR numbers in the filename (0005-file.md) matches the title (# 5. Title)
  • Add ADRs have titles (# Number. Title) as the first line

Usage


- uses: jules2689/adr-action@main
  with:
    adr-dir: '' # Optional. Directory in which ADRs are located. Defaults to contents of .adr-dir
    adr-tool-repo: 'https://github.com/npryce/adr-tools.git' # Optional. ADR Tool Repo location 
    adr-tool-version: '3.0.0' # Optional. Version of the Tools to use.
    github-token: '' # Optional. Token with which to commit
    generate-toc-branches: "['main', 'master']" # Optional: JSON Array of Branch names as a string. specify which branches we should generate TOC on. Defaults to main/master. 

Example

name: ADR

on:
  push: {} # Run on everything, restrict TOC generateion with 'generate-toc-branches'

jobs:
  generate_adr_toc:
    runs-on: ubuntu-latest
    name: Lint ADRs and generate Table of Contents
    steps:
    - uses: actions/checkout@v2
    - uses: jules2689/[email protected]

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published