diff --git a/README.md b/README.md
index f3b33c8..3ee1479 100644
--- a/README.md
+++ b/README.md
@@ -1,24 +1,29 @@
 # food-services-aggregator-spec
 
 ## Table of Contents
-1. [Overview](#Overview)
-2. [Getting Started](#Getting-Started)
-3. [Todo](#Todo)
+1. [Technologies](#Technologies)
+2. [Overview](#Overview)
+3. [Getting Started](#Getting-Started)
 
-## Overview
-This repository houses the endpoint specs for the food-services-aggregator server. The technology of choice is OpenAPI 3.0 because of it's community support and popularity.
+## Technologies
+- OpenAPI 3.0
+- Java
+    - Maven
+    - OpenAPI Generator Maven Plugin
+- Github Actions
+- Github Pages
 
-On pushes to the main branch, three jobs take place.
-1. Server-side stubs and classes are generated for use in the server side and [published to a github package](https://github.com/adam-shamaa/food-services-aggregator-spec/packages/1277138)
-2. Client-side helpers and classes are generated for use on the client side and [published to a github package](https://github.com/adam-shamaa/food-services-aggregator-spec/pkgs/npm/food-services-aggregator-spec)
-3. A swagger-ui page is generated and published to [github pages](https://adam-shamaa.github.io/food-services-aggregator-spec/)
+## Overview
+This repository houses the backend API specs for the food-services-aggregator server.
 
 ## Getting Started
-Make changes directly to [src/main/resources/openapi/openapi.yaml](https://github.com/adam-shamaa/food-services-aggregator-spec/blob/main/src/main/resources/openapi/openapi.yaml)
-
-## Improvements
-- Auto bump version (a super tedious thing that I forget too often)
-- Add ability to generate swagger ui on local development to act as preview (can simply copy and paste into an online tool but a nice to have)
-- Make use of libraries that merge smaller files into a single generated openapi spec file (easier to digest and maintain a structured director and small files)
+1. Make changes directly to the OpenAPI spec [src/main/resources/openapi/openapi.yaml](https://github.com/adam-shamaa/food-services-aggregator-spec/blob/main/src/main/resources/openapi/openapi.yaml)
+    
+    Also update the mvn and npm package version by incrementing the OpenAPI spec version (package versions are inherited from the OpenAPI spec version)
+2. You can preview the generated artifacts by running `mvn clean compile` then looking under `target/generated-sources/`
 
 
+On pushes to the main branch, three jobs take place.
+1. Server-side stubs and classes are generated and [published as a github mvn apache package](https://github.com/adam-shamaa/food-services-aggregator-spec/packages/1277138)
+2. Client-side helpers and classes are generated and [published as a github npm package](https://github.com/adam-shamaa/food-services-aggregator-spec/pkgs/npm/food-services-aggregator-spec)
+3. Swagger-ui page is generated and published to [github pages](https://adam-shamaa.github.io/food-services-aggregator-spec/)
\ No newline at end of file
diff --git a/src/main/resources/openapi/openapi.yaml b/src/main/resources/openapi/openapi.yaml
index bc4da80..09c2a4e 100644
--- a/src/main/resources/openapi/openapi.yaml
+++ b/src/main/resources/openapi/openapi.yaml
@@ -2,7 +2,7 @@ openapi: 3.0.0
 info:
   title: Food Services
   description: Server for the food services aggregator application
-  version: 3.5.8
+  version: 3.5.10
 
 tags:
   - name: FoodServicesAggregator