Skip to content

A Powershell-based lightweight Architecture Decision Records (ADR) tool

Notifications You must be signed in to change notification settings

rdagumampan/adr-ps

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 

Repository files navigation

ADR-PS

A Powershell based command-line tool for working with Lighweight Architecture Decision Records (ADRs).

"Lightweight Architecture Decision Records is a technique for capturing important architectural decisions along with their context and consequences. We recommend storing these details in source control, instead of a wiki or website, as then they can provide a record that remains in sync with the code itself. - Thoughtworks"

Quick Start

ADR-PS is a powershell module you can import in a normal powershell session. The default destination directory is doc\adr.

  1. Copy the adr.psm1 into your solution folder and change the doc\adr into your desired directory.

  2. Open Powershell CLI and import module

    / powershell –ExecutionPolicy Bypass
    / Import-Module .\adr.psm1
  3. Create an ADR repository in the current script location

    / Adr-Init
  4. Create architecture decision record

    / Adr-New "Record architecture decisions"	
    Directory: C:\play\adr-ps\doc\adr
    
    Mode           LastWriteTime         	     Length Name
    ----           -------------         	     ------ ----
    -a----         9/8/2018     07:50            419 0001-record-architecture-decisions.md
    -a----         9/8/2018     07:43            125 ReadMe.md	
  5. Help

    / Adr-Help

Updating module

/ powershell –ExecutionPolicy Bypass
/ Remove-Module adr
/ Import-Module .\adr.psm1

Motivation

ADR-PS aims to help document architecturally significant functional and non-functional decisions through out solution lifetime to benefit current and future teams. I also hope to promote ADR-technique into greater audience with more choice of tools.

The decisions on this tool are recorded as architecture decision records in repository

References

About

A Powershell-based lightweight Architecture Decision Records (ADR) tool

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published