diff --git a/README.md b/README.md
index 3dc4848..37da7ac 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,25 @@
-# tests-actions
+# Gitea Actions testing ground
 
-This repository is meant to test Gitea actions
\ No newline at end of file
+This repository is a testing ground for several Gitea Actions used within the Phyllome OS project.
+
+Gitea Actions workflows closely resemble GitHub Actions workflows, to the point that several GitHub Actions can be used in Gitea Actions workflows without modification.
+
+## How to test actions locally
+
+Download the latest version of the act runner for your architecture [here](https://dl.gitea.com/act_runner/)
+
+Execute the act runner using the `exec` argument and specify the workflow file:
+
+```
+./act_runner exec --workflows my-workflow-in-root-directory.yml 
+```
+
+## How they are used in Phyllome OS
+
+Several known actions repositories are mirrored within Phyllome's Gitea instance, under the [actions](https://git.phyllo.me/actions) organization.
+
+# Good sources
+
+- [Official Gitea Action documentation](https://docs.gitea.com/usage/actions/quickstart) 
+- [Awesome Actions](https://github.com/sdras/awesome-actions#workflow-examples)
+- [GitHub Actions Survival Skills](https://thekevinwang.com/2022/06/13/github-actions-survival-skills)
\ No newline at end of file