thirdparty.adr.templates 1.1.8

dotnet add package thirdparty.adr.templates --version 1.1.8                
NuGet\Install-Package thirdparty.adr.templates -Version 1.1.8                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="thirdparty.adr.templates" Version="1.1.8" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add thirdparty.adr.templates --version 1.1.8                
#r "nuget: thirdparty.adr.templates, 1.1.8"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install thirdparty.adr.templates as a Cake Addin
#addin nuget:?package=thirdparty.adr.templates&version=1.1.8

// Install thirdparty.adr.templates as a Cake Tool
#tool nuget:?package=thirdparty.adr.templates&version=1.1.8                

dotnet adr - Make Future You Thank Past You.

A cross platform .NET Global Tool for creating and managing Architectural Decision Records (ADR).

TLDR;

Architectural Decision Records (ADRs) are simple Markdown documents used to record technical choices for a project by summarizing the context, the decision, and the consequences. dotnet adr is a tool and a bundle of the most common ADR templates you can use to create and maintain ADRs in your solution.

Create your own custom ADR Template Package

While we use MADR as the default template, because it has a nice balance of simplicity and power, it doesn't mean that it's the best template for you, your team, and your organization. First check-out the different templates which are available out of the box. If none of these are suitable then it's easy to make your own!

This repo contains an example extensibility "Third Party" ADR template example located in /Solutions/ThirdParty.Adr.Templates, this is also available via nuget.org as thirdparty.adr.templates.

There are straightforward conventions for creating a customer ADR template package:

  1. Create a folder which matches the name of the template, using kebab-case. i.e. my-custom-adr-template
  2. Inside that folder create a template.md file
  3. Add the following front-matter and mandatory headings to template.md:
---
Title: 
Description: 
Authors: 
Effort: 
More Info: 
Version: 
Last Modified: YYYY-MM-DD HH:MM
---
# Title 

## Status
  1. Create a .csproj file which contains the following properties:
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <AssemblyName>thirdparty.adr.templates</AssemblyName>
    <TargetFramework>net6.0</TargetFramework>
    <IncludeBuildOutput>false</IncludeBuildOutput>
    <SuppressDependenciesWhenPacking>true</SuppressDependenciesWhenPacking>
    
    <EnableDynamicLoading>true</EnableDynamicLoading>
  </PropertyGroup>

  <PropertyGroup>
    <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
    <PackageDescription>An example demonstrating how a 3rd Party could create a dotnet-adr template package.</PackageDescription>
    <PackageTags>dotnet-adr dotnet-adr-template architecture tools endjin</PackageTags>
    <PackageReleaseNotes></PackageReleaseNotes>
  </PropertyGroup>

  <ItemGroup>
    <Content Include="my-custom-adr-template\template.md">
      <PackagePath>content\my-custom-adr-template</PackagePath>
      <Pack>true</Pack>
    </Content>
  </ItemGroup>

</Project>
  1. When the solution is built, a thirdparty.adr.templates.nupkg NuGet package will be created. Publish this to nuget.org

To swap between the packages use the following adr commands:

adr templates package set thirdparty.adr.templates

Next, to download the latest version of 'thirdparty.adr.templates` use the command:

adr templates install

To see the currently set default package, use:

adr templates package show

To see the id of the currently set default template, use:

adr templates show

To revert to the "official" ADT Template Package you can either, reset the environment:

adr environment reset

or:

adr templates package set adr.templates

Then:

adr templates install

More Information

An extensive readme is available in the GitHub repository.

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.1.8 244 3/21/2024
1.1.7 2,971 11/25/2023
1.1.6 173 7/3/2023
1.1.5 114 6/26/2023
1.1.4 130 6/23/2023
1.1.3 109 6/22/2023
1.1.2 106 6/22/2023
1.1.1 137 6/20/2023
1.1.0 130 6/19/2023
1.0.0 128 6/19/2023
0.1.0-preview.36 569 1/16/2020
0.1.0-preview.34 237 1/16/2020
0.1.0-preview.32 260 1/16/2020
0.1.0-preview.31 263 1/16/2020