diff --git a/README.md b/README.md
new file mode 100644
index 0000000..18e8ba3
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# Kaniko Action
+
+Build OCI images using Kaniko, with the Dockerfile contents provided directly as an action input.
+
+## Usage
+
+Example:
+
+```yaml
+jobs:
+  cowsay:
+    runs-on: docker
+    steps:
+      - uses: https://git.kabelsalat.ch/s3lph/forgejo-kaniko-action@v1
+        with:
+          dockerfile: |
+            FROM debian:latest
+            RUN apt update && apt install --yes cowsay
+          image: docker.example.org/example/cowsay:latest
+          registry: docker.example.org
+          username: ${{ secrets.REGISTRY_USERNAME }}
+          password: ${{ secrets.REGISTRY_PASSWORD }}
+```
diff --git a/action.yml b/action.yml
index 8243765..3d61d87 100644
--- a/action.yml
+++ b/action.yml
@@ -14,10 +14,10 @@ inputs:
     required: true
   username:
     description: Username for the container registry
-    required: false
+    required: true
   password:
     description: Password for the container registry
-    required: false
+    required: true
 runs:
   using: docker
   image: docker://gcr.io/kaniko-project/executor:debug