diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9bee6cf
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# Gitea actions demo repository.
+
+If you need assistance or have any questions, feel free to contact support.
+
+### Demo workflow:
+
+* [Workflow configuration](https://git.runx.zip/runx/gitea-actions-demo/src/branch/main/.gitea/workflows/gitea-ci.yaml)
+* [Workflow demo](https://git.runx.zip/runx/gitea-actions-demo/actions/runs/1/jobs/0)
+
+### Useful links:
+
+* [Gitea actions docs](https://docs.gitea.com/next/usage/actions/quickstart)
+* [Github actions docs](https://docs.github.com/en/actions/writing-workflows/quickstart)
+* [Actions marketplace](https://github.com/marketplace?type=actions)
+
+### Usage Requirements:
+
+* Do not use third-party runner images.
+* Delete images after the workflow execution.
+* Try to break down the workflow into steps.
+