diff --git a/docs.md b/docs.md
new file mode 100644
index 0000000..3720bf0
--- /dev/null
+++ b/docs.md
@@ -0,0 +1,64 @@
+---
+name: Gitea Generic Package
+icon: https://raw.githubusercontent.com/go-gitea/gitea/main/assets/logo.svg
+description: Plugin to Publish Artifacts to Gitea Generic Package Registry.
+author: OCram85
+tags: [Gitea, publish-package, container, build]
+containerImage: ocram85/plugin-gitea-package
+containerImageUrl: https://hub.docker.com/r/ocram85/plugin-gitea-package
+url: https://codeberg.org/woodpecker-plugins/docker-buildx
+---
+
+# Overview
+
+Woodpecker CI plugin to upload any file to the _Gitea Generic Package Registry_.
+
+For details about the features and limits of the _Generic Package Registry_ their [docs](https://docs.gitea.com/usage/packages/generic).
+
+## Settings
+
+| Settings Name | Default | Description               |
+| ------------- | ------- | ------------------------- |
+| `user`        | _none_  | Gitea user for basic auth |
+| `password`    | _none_  | Password for basic auth |
+| `debug` | _none_ | Enables debug output if it's set to `true`. |
+| `owner` | _none_ | Package owner |
+| `package_name` | _none_ | The package name |
+| `package_version` | _none_ | Package version |
+| `file_source` | _none_ | File source path for upload. |
+| `file_name` | _none_ | Package file name |
+| `update` | `false` | Allow update existing package files |
+
+## Examples
+
+```yaml
+when:
+  - event: [pull_request, tag, cron]
+  - event: push
+    branch:
+      - ${CI_REPO_DEFAULT_BRANCH}
+
+depends_on:
+  - "ci"
+
+steps:
+  next:
+    image: ocram85/plugin-gitea-package:latest
+    pull: true
+    secrets: [ gitea_user, gitea_passwd]
+    settings:
+      user:
+        from_secret: gitea_user
+      password:
+        from_secret: gitea_passwd
+      debug: "true"
+      owner: "plugins"
+      package_name: "dummy_package"
+      package_version: "0.1.0"
+      file_source: "./README.md"
+      file_name: "readme.md"
+      update: "true"
+    when:
+      event: pull_request
+      branch: ${CI_REPO_DEFAULT_BRANCH}
+```