globtec / phpadr

A PHP based command-line interface tool for working with Architecture Decision Records (ADR)

ADR Tools in PHP

A PHP based command-line interface tool for working with Architecture Decision Records (ADR).

About ADR

Architecture Decision Records (ADR) is a technique for capturing important architectural decisions, along with their context and consequences as described by Michael Nygard in his article: Documenting Architecture Decisions.

Requirements

• Requires PHP version 7.1.3 or newer
• Multibyte String extension

Installation

You can install this tool using the Composer, execute the following command.

composer require globtec/phpadr --dev

Usage

After of install this project you may execute the binary phpadr in your terminal:

./vendor/bin/phpadr

If to execute the command above, it will be showd a list of all avaliable tool commands.

By default the records will be stored in docs/arch, to change this workspace use the option --config with the path of the config file.

Create a new ADR

You may use the make:decision command:

./vendor/bin/phpadr make:decision <title> [<status="Accepted">] [--config="adr.yml"]

Count the ADRs

You may use the workspace:count command:

./vendor/bin/phpadr workspace:count [--config="adr.yml"]

List the ADRs

You may use the workspace:list command:

./vendor/bin/phpadr workspace:list [--config="adr.yml"]

Help

For more help execute the following command:

./vendor/bin/phpadr <command> --help

phpadr's Issues

New release?

Hey there,

you have made some code changes, for example bumped the symfony/console version.

Will there be a new tag and release or should this repo and the package be considered abandoned?
There is no shame in that, open source is hard work. But, please, let us know :)

func0der

Add support for Symfony 7

Please

New release

Hi @globtec,

Do you have an idea when the current master branch will be tagged for a new release?

Cheers, Frank