diff --git a/docs/src/pages/awesome.md b/docs/src/pages/awesome.md
index aac85d036..94dc8cd7a 100644
--- a/docs/src/pages/awesome.md
+++ b/docs/src/pages/awesome.md
@@ -1,8 +1,8 @@
 # Awesome Woodpecker
 
-A curated list of awesome things related to Woodpecker CI.
+A curated list of assets (tools, projects, blog posts) related to Woodpecker CI.
 
-If you have some missing resources, please feel free to [open a pull-request](https://github.com/woodpecker-ci/woodpecker/edit/main/docs/docs/92-awesome.md) and add them.
+If you want to add a new entry, open a [pull-request](https://github.com/woodpecker-ci/woodpecker/edit/main/docs/docs/92-awesome.md).
 
 ## Official Resources
 
@@ -52,7 +52,7 @@ If you have some missing resources, please feel free to [open a pull-request](ht
 - [Quest For CICD - WoodpeckerCI](https://omaramin.me/posts/woodpecker/)
 - [Getting started with Woodpecker CI](https://systeemkabouter.eu/getting-started-with-woodpecker-ci.html)
 - [Installing gitea and woodpecker using binary packages](https://neelex.com/2023/03/26/Installing-gitea-using-binary-packages/)
-- [Deploying mdbook to codeberg pages using woodpecker CI](https://www.markpitblado.me/blog/deploying-mdbook-to-codeberg-pages-using-woodpecker-ci/)
+- [Deploying mdbook to codeberg pages using Woodpecker CI](https://www.markpitblado.me/blog/deploying-mdbook-to-codeberg-pages-using-woodpecker-ci/)
 - [Deploy a Fly app with Woodpecker CI](https://joeroe.io/2024/01/09/deploy-fly-woodpecker-ci.html)
 - [Ansible - using Woodpecker as an alternative to Semaphore](https://pat-s.me/ansible-using-woodpecker-as-an-alternative-to-semaphore/)
 - [Simple selfhosted CI/CD with Woodpecker](https://xyquadrat.ch/blog/simple-ci-with-woodpecker/)