Unleash · thomasheartman · Oct 19, 2022 · Sep 27, 2022 · Sep 27, 2022 · Sep 27, 2022
diff --git a/docs/api/oas/openapi.yaml b/docs/api/oas/openapi.yaml
diff --git a/frontend/README.md b/frontend/README.md
@@ -15,7 +15,9 @@ yarn run start
 
 ## Run with a heroku-hosted instance of unleash-api
 
-Alternatively, instead of running unleash-api on localhost, use a remote instance:
+<!-- todo: update this after updating the package.json -->
+
+Alternatively, instead of running unleash-api on localhost, you can use a remote instance:
 
 ```
 cd ~/frontend

diff --git a/frontend/package.json b/frontend/package.json
@@ -13,7 +13,7 @@
     "build": "vite build",
     "lint": "eslint src --max-warnings 0",
     "start": "vite",
-    "start:heroku": "UNLEASH_API=https://unleash.herokuapp.com yarn run start",
+    "start:heroku": "UNLEASH_API=https://unleash.herokuapp.com yarn run start", // <— what do we here?
     "start:enterprise": "UNLEASH_API=https://unleash4.herokuapp.com yarn run start",
     "start:demo": "UNLEASH_BASE_PATH=/demo/ yarn start",
     "test": "tsc && vitest run",

diff --git a/website/.gitignore b/website/.gitignore
@@ -20,6 +20,6 @@ yarn-debug.log*
 yarn-error.log*
 
 # OpenAPI docusaurus generated stuff
-docs/reference/apis/**/sidebar.js
+docs/reference/api/**/sidebar.js
 *.api.mdx
 *.tag.mdx
@@ -63,7 +63,7 @@ Example with curl:
 ```sh
 curl -X GET -H "Content-Type: application/json" \
   -H "Authorization: Basic YWRtaW46" \
-  http://unleash.herokuapp.com/api/admin/state/export?&featureToggles=1&strategies=0 > export.json
+  https://unleash.example.com/api/admin/state/export?&featureToggles=1&strategies=0 > export.json
 ```
 
 ### API Import {#api-import}

@@ -47,8 +47,6 @@ Examples of custom authentication hooks:
 - [basic-auth-hook.js](https://github.com/Unleash/unleash-examples/blob/7ed25f97a31dfd8f773c00847080b1a4c889fd87/v3/securing-basic-auth/basic-auth-hook.js)
 - [keycloak-auth-hook.js](https://github.com/Unleash/unleash-examples/blob/7ed25f97a31dfd8f773c00847080b1a4c889fd87/v3/securing-keycloak-auth/keycloak-auth-hook.js)
 
-We also have a version of Unleash deployed on Heroku which uses Google OAuth 2.0: https://secure-unleash.herokuapp.com
-
 ## Securing the Client API {#securing-the-client-api}
 
 A common way to support client access is to use pre-shared secrets. This can be solved by having clients send a shared key in an HTTP header with every client request to the Unleash API. All official Unleash clients should support this.

@@ -65,7 +65,7 @@ The steps to implement a custom strategy for your client depend on the kind of c
    }
 
    const instance = initialize({
-     url: 'http://unleash.herokuapp.com/api/',
+     url: 'https://unleash.example.com/api/',
      appName: 'unleash-demo',
      instanceId: '1',
      // highlight-next-line

@@ -32,7 +32,7 @@ func init() {
 	unleash.Initialize(
 		unleash.WithListener(&unleash.DebugListener{}),
 		unleash.WithAppName("my-application"),
-		unleash.WithUrl("http://unleash.herokuapp.com/api/"),
+		unleash.WithUrl("https://unleash.example.com/api/"),
         unleash.WithCustomHeaders(http.Header{"Authorization": {"<API token>"}}),
 	)
 }

@@ -111,7 +111,7 @@ UnleashContextProvider contextProvider = new MyAwesomeContextProvider();
 UnleashConfig config = new UnleashConfig.Builder()
             .appName("java-test")
             .instanceId("instance x")
-            .unleashAPI("http://unleash.herokuapp.com/api/")
+            .unleashAPI("https://unleash.example.com/api/")
             .unleashContextProvider(contextProvider)
             .build();
 

@@ -90,7 +90,7 @@ $contextProvider = new MyAwesomeContextProvider();
 $unleash = UnleashBuilder::create()
     ->withAppName('my.php-app')
     ->withInstanceId('your-instance-1')
-    ->withAppUrl('http://unleash.herokuapp.com/api/')
+    ->withAppUrl('https://unleash.example.com/api/')
     ->withContextProvider($contextProvider)
     ->build();
 

@@ -62,7 +62,7 @@ The reference docs are organized into the following topics:
 
 ## Other resources and communities
 
-💻 The core of Unleash is all open source and [hosted on GitHub](https://www.heroku.com/deploy/?template=https://github.com/Unleash/unleash 'Unleash on GitHub').
+💻 The core of Unleash is all open source and [hosted on GitHub](https://github.com/Unleash/unleash/ 'Unleash on GitHub').
 
 💬 If you've got questions or just wanna chat to the team and other Unleash users, come [join our Slack community](https://slack.unleash.run/)
 

@@ -115,21 +115,30 @@ Now you can fetch the feature toggle you created and try turning it on / off in
 
 If you want to set up your own instance for testing purposes you can easily do so by using one of our premade setup kits for Heroku or DigitalOcean.
 
-> The Heroku instance setup is FREE, and includes a DB to save your state but it will eventually go to sleep when not used. The DigitalOcean setup utilises droplets and will cost you around $10/month to run, but in turn it will not go to sleep. NOTE: If you use the DigitalOcean link below and are a new user, you will receive $100 in FREE credits.
+::: info Pricing
 
-### Deploy a free version of Unleash to Heroku
+Both DigitalOcean and Heroku will charge you for running Unleash on their services. However, if you use the DigitalOcean link below and are a new user, you will receive $100 in free credits.
+
+:::
+
+### Deploy a paid version of Unleash to Heroku
 
 [![Deploy to Heroku](https://www.herokucdn.com/deploy/button.png)](https://www.heroku.com/deploy/?template=https://github.com/Unleash/unleash)
 
 ### Deploy a paid version of Unleash to DigitalOcean
 
-> You'll receive $100 in free credits if you are a new DigitalOcean user using this link.
+:::tip Free credits
+
+
+You'll receive $100 in free credits if you are a new DigitalOcean user using this link.
+
+:::
 
 [![Deploy to DigitalOcean](https://www.deploytodo.com/do-btn-blue.svg)](https://cloud.digitalocean.com/apps/new?repo=https://github.com/Unleash/unleash/tree/main&refcode=0e1d75187044)
 
 ### Accessing your new instance
 
-Once you have set up the new instance, click the URL provided by either Heroku or DigitalOcean and you'll be taken to the application login screen.
+Once you have set up the new instance, follow the URL provided by either Heroku or DigitalOcean and it will take you to the application login screen.
 
 Input the following credentials to log in:
 

@@ -13,6 +13,7 @@ Before you can connect your application to Unleash you need a Unleash server. Yo
 1. **Unleash Open-source**
    - [Docker](../deploy/getting-started.md)
    - [Helm Chart](https://github.com/unleash/helm-charts/)
+   <!-- todo: what do we do about this? -->
    - [Click-to-deploy on Heroku](https://www.heroku.com/deploy/?template=https://github.com/Unleash/unleash)
    - [GitLab](https://docs.gitlab.com/ee/operations/feature_flags.html#choose-a-client-library)
 2. **Unleash Enterprise**

@@ -179,6 +179,10 @@ module.exports = {
                         from: '/advanced/audit_log',
                         to: '/reference/event-log',
                     },
+                    {
+                        from: '/api/open_api',
+                        to: '/reference/api/unleash',
+                    },
                 ],
                 createRedirects: function (toPath) {
                     if (