Update readme and changelog (#78)

* Update readme and changelog

* Update CHANGELOG.md with snippets and status bar changes

Author: garrytrinder

CHANGELOG.md

@@ -5,7 +5,41 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.3.0] - 2024-04-25
+
+### Added:
+
+- Config diagnostic: Schema check support for beta installations
+- Dev Proxy detection: Support for beta installations
+- Setting: Version Preference setting determines which version toolkit should use when installed side-by-side
+- Snippet: `devproxy-plugin-api-center-onboarding` - ApiCenterOnboardingPlugin instance
+- Snippet: `devproxy-plugin-api-center-onboarding-config` - ApiCenterOnboardingPlugin config section
+- Snippet: `devproxy-plugin-api-center-production-version` - ApiCenterProductionVersionPlugin instance
+- Snippet: `devproxy-plugin-api-center-production-version-config` - ApiCenterProductionVersionPlugin config section
+- Snippet: `devproxy-plugin-entra-mock-response` - EntraMockResponsePlugin instance
+- Snippet: `devproxy-plugin-entra-mock-response-config` - EntraMockResponsePlugin config section
+- Snippet: `devproxy-plugin-mock-request` - MockRequestPlugin instance
+- Snippet: `devproxy-plugin-mock-request-config` - MockRequestPlugin config section
+- Code Lens: `ApiCenterOnboardingPlugin`
+- Code Lens: `ApiCenterProductionVersionPlugin`
+- Code Lens: `EntraMockResponsePlugin`
+- Code Lens: `MockRequestPlugin`
+
+### Changed:
+
+- Snippets: All snippets that reference schemas updated to use `v0.17.1` schema
+- Snippets: Removed trailing comma from config section snippets
+- Status bar: Replaced sync icon with loading icon
+- Readme: Snippets table updated
+- Dev Proxy detection: Improved latest version check logic, uses `devproxy outdated -s` command
+
+### Fixed:
+
+- Fixed broken link on `OpenApiSpecGeneratorPlugin` code lens
+
+### Removed:
+
+- Config diagnostic: Check for empty `urlsToWatch`
 
 ## [0.2.0] - 2024-02-15
 

README.md

@@ -1,11 +1,49 @@
 # Dev Proxy Toolkit
 
-[Dev Proxy](https://aka.ms/devproxy) is a command line tool that helps you simulate behaviors and errors of cloud APIs.
+[Dev Proxy](https://aka.ms/devproxy) is an API simulator that helps you effortlessly test your app beyond the happy path.
 
 The Dev Proxy Toolkit extension for Visual Studio Code makes it easy to create and update configuration files.
 
+> **IMPORTANT**
+>
+> Dev Proxy Toolkit is designed to be used with the latest version of Dev Proxy, v0.17.1. If you are using an earlier build some features may not work as intended.
+>
+
 ## Features
 
+The following sections describe the features that the extension contributes to Visual Studio Code when installed
+
+### Diagnostics
+
+- Check for missing `configSection` property in plugin instance for plugins that require configuration
+- Check for missing `configSection` when defined in plugin instance
+- Check that schema matches installed version of Dev Proxy
+
+### Code Actions
+
+- Update schema to match installed version of Dev Proxy
+
+### Code Lenses
+
+- Plugin documentation link
+
+### Notifications
+
+- Not installed
+- New version detection
+
+### Status Bar
+
+- Display installed Dev Proxy version
+- Display waring when Dev Proxy is not latest version
+- Display tick if Dev Proxy is latest version (check based on `newVersionNotification` config setting)
+- Display radio tower when Dev Proxy is running
+- Display error is Dev Proxy is not installed
+
+### Settings
+
+- `devproxytoolkit.versionPreference` - Determines the version to use when Dev Proxy and Dev Proxy Beta are installed side by side. Can be `stable` (default) or `beta`.
+
 ### Snippets
 
 | Prefix | Description |
@@ -66,21 +104,3 @@ The Dev Proxy Toolkit extension for Visual Studio Code makes it easy to create a
 | `devproxy-plugin-rate-limiting-file` | Dev Proxy rate limiting file |
 | `devproxy-plugin-rate-limiting-file-schema` | Dev Proxy rate limiting file schema |
 | `devproxy-plugin-retry-after` | RetryAfterPlugin instance |
-
-### Diagnostics
-
-The following diagnostic checks are performed:
-
-- Check for empty `urlsToWatch`
-- Check for missing `configSection` property in plugin instance for plugins that require configuration
-- Check for missing `configSection` when defined in plugin instance
-- Check that schema matches installed version of Dev Proxy
-- Code action to update schema to correct version
-
-### Dev Proxy detection
-
-The following checks are performed:
-
-- Check if Dev Proxy is installed
-- Check if Dev Proxy is the latest version
-- Check if Dev Proxy is running