From 8c9b201842fab03dae0af014cd374d9c99dcfd56 Mon Sep 17 00:00:00 2001
From: eric sciple <ericsciple@users.noreply.github.com>
Date: Thu, 13 Feb 2020 15:53:04 -0500
Subject: [PATCH] adr support fetch-refs

---
 adrs/0153-checkout-v2.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/adrs/0153-checkout-v2.md b/adrs/0153-checkout-v2.md
index 29cdb02..981b114 100644
--- a/adrs/0153-checkout-v2.md
+++ b/adrs/0153-checkout-v2.md
@@ -43,12 +43,18 @@ We want to take this opportunity to make behavioral changes, from v1. This docum
   fetch-depth:
     description: 'Number of commits to fetch. 0 indicates all history.'
     default: 1
+  fetch-refs:
+    description: >
+      Additional refs to fetch: `branches`, `tags`, `pr-base`, or `all`.
+      Combinations are also accepted. For example: `branches, tags`
+    default: ''
   lfs:
     description: 'Whether to download Git-LFS files'
     default: false
 ```
 
 Note:
+- `fetch-refs` is new
 - `persist-credentials` is new
 - `path` behavior is different (refer [below](#path) for details)
 - `submodules` was removed (error if specified; add later if needed)
@@ -85,6 +91,8 @@ If a SHA isn't available (e.g. multi repo), then fetch only the specified ref wi
 
 The input `fetch-depth` can be used to control the depth.
 
+The input `fetch-refs` can be used to fetch additional refs.
+
 Note:
 - Fetching a single commit is supported by Git wire protocol version 2. The git client uses protocol version 0 by default. The desired protocol version can be overridden in the git config or on the fetch command line invocation (`-c protocol.version=2`). We will override on the fetch command line, for transparency.
 - Git client version 2.18+ (released June 2018) is required for wire protocol version 2.