diff --git a/README.md b/README.md
index 992554a..e111dcb 100644
--- a/README.md
+++ b/README.md
@@ -1,2 +1,128 @@
 # GitHub Action: Run ruff with reviewdog
 
+[![depup](https://github.com/benny123tw/action-ruff/workflows/depup/badge.svg)](https://github.com/benny123tw/action-ruff/actions?query=workflow%3Adepup)
+[![release](https://github.com/benny123tw/action-ruff/workflows/release/badge.svg)](https://github.com/benny123tw/action-ruff/actions?query=workflow%3Arelease)
+[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/benny123tw/action-ruff?logo=github&sort=semver)](https://github.com/benny123tw/action-ruff/releases)
+[![action-bumpr supported](https://img.shields.io/badge/bumpr-supported-ff69b4?logo=github&link=https://github.com/haya14busa/action-bumpr)](https://github.com/haya14busa/action-bumpr)
+<!-- [![Used-by counter](https://img.shields.io/endpoint?url=https://haya14busa.github.io/github-used-by/data/reviewdog/action-eslint/shieldsio.json)](https://github.com/haya14busa/github-used-by/tree/main/repo/reviewdog/action-eslint) -->
+
+This action runs [ruff](https://docs.astral.sh/ruff/) with
+[reviewdog](https://github.com/reviewdog/reviewdog) on pull requests to improve
+code review experience.
+
+[![github-pr-check sample](sample.png)](https://github.com/benny123tw/action-ruff/pull/1)
+
+## Inputs
+
+### `github_token`
+
+**Required**. Default is `${{ github.token }}`.
+
+### `level`
+
+Optional. Report level for reviewdog \[`info`,`warning`,`error`\].
+It's same as `-level` flag of reviewdog.
+
+### `reporter`
+
+Reporter of reviewdog command \[`github-pr-check`,`github-check`,`github-pr-review`\].
+Default is `github-pr-review`.
+It's same as `-reporter` flag of reviewdog.
+
+`github-pr-review` can use Markdown and add a link to rule page in reviewdog reports.
+
+### `filter_mode`
+
+Optional. Filtering mode for the reviewdog command \[`added`,`diff_context`,`file`,`nofilter`\].
+Default is added.
+
+### `fail_level`
+
+Optional. If set to `none`, always use exit code 0 for reviewdog. Otherwise, exit code 1 for reviewdog if it finds at least 1 issue with severity greater than or equal to the given level.
+Possible values: [`none`, `any`, `info`, `warning`, `error`]
+Default is `none`.
+
+### `fail_on_error`
+
+Deprecated, use `fail_level` instead.
+Optional. Exit code for reviewdog when errors are found \[`true`,`false`\]
+Default is `false`.
+
+### `reviewdog_flags`
+
+Optional. Additional reviewdog flags
+
+### `ruff_flags`
+
+Optional. Flags and args of ruff command.
+
+### `workdir`
+
+Optional. The directory from which to look for and run eslint. Default '.'
+
+### `changed_files`
+
+Optional. Whether to only run Ruff on changed files. Defaults to `true`.
+Default is `true`.
+
+## Example usage
+
+This action installs [uv] and [reviewdog] for you. It runs [ruff] with [uvx], so there's no need for manual installation.
+
+### [.github/workflows/reviewdog.yml](.github/workflows/reviewdog.yml)
+
+```yaml
+name: reviewdog
+on: [pull_request]
+jobs:
+  ruff:
+    name: runner / ruff
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: benny123tw/action-ruff@v1
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          reporter: github-pr-review # Change reporter.
+```
+
+You can also set up uv and ruff manually like below.
+
+```yml
+name: reviewdog
+on: [pull_request]
+jobs:
+  eslint:
+    name: runner / eslint
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+      - name: Set up Python 3.12
+        run: uv python install 3.12
+      - run: uv sync --frozen
+      - uses: benny123tw/action-ruff@v1
+        with:
+          reporter: github-check
+```
+
+## Acknowledgments
+
+action-ruff is made possible thanks to the inspirations from the following resources and projects:
+
+* [Python プロジェクトをReviewdogでチェックする](https://kujilabo.com/2023/03/13/2023/03/python_003/)
+* [Add RDJson support #11682](https://github.com/astral-sh/ruff/pull/11682)
+* [reviewdog/action-eslint](https://github.com/reviewdog/action-eslint)
+* [astral-sh/ruff-action](https://github.com/astral-sh/ruff-action)
+
+[uv]: https://docs.astral.sh/uv/
+[uvx]: https://docs.astral.sh/uv/guides/tools/#running-tools
+[ruff]: https://docs.astral.sh/ruff/
+[reviewdog]: https://github.com/reviewdog/reviewdog
\ No newline at end of file
diff --git a/action.yml b/action.yml
index 2ea0c34..1fd3403 100644
--- a/action.yml
+++ b/action.yml
@@ -44,7 +44,7 @@ inputs:
   ruff_flags:
     description: "flags and args of ruff command. Default: '.'"
     required: false
-    default: '.'
+    default: ''
   workdir:
     description: "The directory from which to look for and run eslint. Default '.'"
     required: false
@@ -54,7 +54,7 @@ inputs:
     required: false
     default: 'eslint'
   changed_files:
-    description: 'Whether to only run Ruff on hanged files. Defaults to `true`.'
+    description: 'Whether to only run Ruff on changed files. Defaults to `true`.'
     required: false
     default: 'true'
 runs:
diff --git a/sample.png b/sample.png
new file mode 100644
index 0000000..43e9917
Binary files /dev/null and b/sample.png differ