diff --git a/api-docs/README.md b/api-docs/README.md
index ea0f87c67..af58a27ed 100644
--- a/api-docs/README.md
+++ b/api-docs/README.md
@@ -1,11 +1,11 @@
 ## Exploring or editing the Swagger API documentation
 
-The `swagger.yml` file can be viewed and edited in the Swagger UI.
+The `spec.openapi.yml` file can be viewed and edited in the Swagger UI.
 
 * Head over to the [Swagger editor](http://editor.swagger.io/)
 
 * Now click File -> Import URL
 
-* Type in `https://raw.githubusercontent.com/openfaas/faas/master/api-docs/swagger.yml` and click OK
+* Type in `https://raw.githubusercontent.com/openfaas/faas/master/api-docs/spec.openapi.yml` and click OK
 
 You can now view and edit the Swagger, copy back to your fork before pushing changes.