diff --git a/CHANGELOG.md b/CHANGELOG.md
index 73199d52..84f579e7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -34,7 +34,7 @@
 
 ### `reitit-swagger`
 
-* New module to produce swagger-docs from routing tree, including `Coercion` definitions. Works with both middleware & interceptors and Schema & Spec. See [docs](https://metosin.github.io/reitit/ring/swagger.html).
+* New module to produce swagger-docs from routing tree, including `Coercion` definitions. Works with both middleware & interceptors and Schema & Spec. See [docs](https://metosin.github.io/reitit/ring/swagger.html) and [example project](https://github.com/metosin/reitit/tree/master/examples/ring-swagger).
 
 ### `reitit-swagger-ui`
 
diff --git a/README.md b/README.md
index 72e3483e..bdb9e2e2 100644
--- a/README.md
+++ b/README.md
@@ -133,7 +133,7 @@ Invalid request:
 * content negotiation library like [Muuntaja](https://github.com/metosin/muuntaja)
 * some default Ring-middleware like `ring.middleware.params/wrap-params`
 
-See [Ring with Swagger Example](/tree/master/examples/ring-swagger) for a runnable example. Plan is to have more batteries as separate modules, templates and example projects. Stay tuned.
+See [Ring with Swagger Example](https://github.com/metosin/reitit/tree/master/examples/ring-swagger) for a runnable example. Plan is to have more batteries as separate modules, templates and example projects. Stay tuned.
 
 ## More info