From 6ef22436462097b19f6b6d7dae9d3123789d8f6d Mon Sep 17 00:00:00 2001
From: David JENNI <david@davidjenni.com>
Date: Tue, 25 May 2021 09:07:53 -0700
Subject: [PATCH] add release notes for first pub release (#47)

* add release notes for first pub release

* capture build version info
---
 .azure-pipelines/OfficialBuild.yml |  9 ++++++---
 README.md                          | 22 ++++++++++++++++++++++
 2 files changed, 28 insertions(+), 3 deletions(-)

diff --git a/.azure-pipelines/OfficialBuild.yml b/.azure-pipelines/OfficialBuild.yml
index a11ecf03..ce217c35 100644
--- a/.azure-pipelines/OfficialBuild.yml
+++ b/.azure-pipelines/OfficialBuild.yml
@@ -17,8 +17,8 @@ variables:
   # AZ_DevOps_Read_PAT  # PAT to read from AzDO feed in msazure
   # VSIX_VERSION        # VSIX package/release version; must be manually managed for now!
 
-trigger:
-  - release/*
+# trigger:
+#   - release/*
 
 # PR loops only via GH workflows
 pr: none
@@ -30,6 +30,9 @@ steps:
 - script: echo "##vso[build.updatebuildnumber]$(VSIX_VERSION)
   displayName: Set Job version
 
+- script: mkdir package && echo $(VSIX_VERSION),$(Build.SourceVersion) > package/version.csv
+  displayName: Capture build version in package/version.csv
+
 - task: NodeTool@0
   displayName: 'Use nodejs 14.x'
   inputs:
@@ -51,7 +54,7 @@ steps:
 #   displayName: 'checkout release/$(Build.SourceBranchName) - (release-it cannot work on detached heads)'
 
 - task: Npm@1
-  displayName: 'increment version via npm'
+  displayName: 'set version via npm'
   inputs:
     command: custom
     customCommand: run increment-version-npm
diff --git a/README.md b/README.md
index 5d5f1e6b..ae71864c 100644
--- a/README.md
+++ b/README.md
@@ -13,6 +13,24 @@ Installing this extension will also make the latest Power Platform CLI (aka pac)
 
 ![VSCode Terminal with pac CLI](https://github.com/microsoft/powerplatform-vscode/blob/main/src/client/assets/pac-CLI-in-terminal.png?raw=true)
 
+## Release Notes
+
+0.2.8:
+
+- initial public preview:
+  - pac CLI installed and runnable in VSCode terminal (cmd, PS, pwsh, git bash, any macOS shell like zsh, fish)
+  - PA Portal language services and auto complete
+- known issues:
+  - macOS: no good check if the required separate install of dotnetCore 3.x or 5.x is present
+  - macOS: 'pac auth create' interactive flow not yet working, pls supply credentials with --username/--password (or appId triple)
+
+
+## Requirements
+
+- VSCode >= 1.5x
+- .NET Windows 4.x
+- macOS: dotnetCore SDK 3.x or 5.x
+
 ## Getting Started
 
 Open the VS Code Terminal (Terminal | New Terminal) and type in:
@@ -78,6 +96,10 @@ Listing all Solutions from the current Dataverse Organization...
  [5]     MicrosoftPortalDependencies    Dynamics 365 Portals - Portal dependencies       9.2.2103.0
 ```
 
+## Feedback & Questions
+
+Please use the issues tracker in the home repo: <https://github.com/microsoft/powerplatform-vscode/issues>
+
 ## Contributing
 
 **PRE-RELEASE SOFTWARE.**