Added some extra messaging to the build output to help get things set up straight

Author: davidkeaveny

src/GitVersion.Core/BuildAgents/BitBucketPipelines.cs

@@ -1,4 +1,4 @@
-using GitVersion.Logging;
+using GitVersion.Logging;
 using GitVersion.OutputVariables;
 
 namespace GitVersion.BuildAgents;
@@ -24,24 +24,19 @@ public override string[] GenerateSetParameterMessage(string name, string value)
         $"GITVERSION_{name.ToUpperInvariant()}={value}"
     };
 
-    public override string? GetCurrentBranch(bool usingDynamicRepos)
-    {
-        var branchName = EvaluateEnvironmentVariable(BranchEnvironmentVariableName);
-        if (branchName != null && branchName.StartsWith("refs/heads/"))
-        {
-            return branchName;
-        }
-
-        return null;
-    }
-
     public override void WriteIntegration(Action<string?> writer, VersionVariables variables, bool updateBuildNumber = true)
     {
         if (this.file is null)
             return;
 
         base.WriteIntegration(writer, variables, updateBuildNumber);
         writer($"Outputting variables to '{this.file}' ... ");
+        writer("To import the file into your build environment, add the following line to your build step:");
+        writer($"  - source {this.file}");
+        writer("");
+        writer("To reuse the file across build steps, add the file as a build artifact:");
+        writer("  artifacts:");
+        writer($"    - {this.file}");
 
         var exports = variables
             .Select(variable => $"export GITVERSION_{variable.Key.ToUpperInvariant()}={variable.Value}")
@@ -50,6 +45,16 @@ public override void WriteIntegration(Action<string?> writer, VersionVariables v
         File.WriteAllLines(this.file, exports);
     }
 
+    public override string? GetCurrentBranch(bool usingDynamicRepos)
+    {
+        var branchName = EvaluateEnvironmentVariable(BranchEnvironmentVariableName);
+        if (branchName != null && branchName.StartsWith("refs/heads/"))
+        {
+            return branchName;
+        }
+
+        return null;
+    }
 
     private string? EvaluateEnvironmentVariable(string variableName)
     {