docs: update document

Author: piquark6046

README.ko.md

@@ -0,0 +1,22 @@
+## tinyShield
+
+[![jsdelivr stat](https://data.jsdelivr.com/v1/package/npm/@list-kr/tinyshield/badge)](https://www.jsdelivr.com/package/npm/@list-kr/tinyshield)
+
+tinyShield 유저스크립트는 애드쉴드 광고와 안티-애드블록을 차단합니다.
+
+tinyShield 유저스크립트는 AdGuard와 애드블록 커뮤니티에 의해 관리되고 있습니다.
+
+> [!IMPORTANT]
+> tinyShield 유저스크립트 유지보수자는 tinyShield 유저스크립트와 함께 아래 애드블록들 중 하나를 사용하실 것을 권장합니다:
+> - AdGuard
+> - uBlock Origin
+> - Brave 웹 브라우저의 Shield
+> - AdBlock Plus
+> - Ghostery
+>
+> 다른 애드블록 지원은 보장되지 않습니다.
+
+### 빠른 시작
+아래 URL를 클릭하여 설치해주세요:
+
+https://cdn.jsdelivr.net/npm/@list-kr/tinyshield@latest/dist/tinyShield.user.js

README.md

@@ -1,4 +1,94 @@
-# tinyShield
-tinyShield provides an alternative version of microShield userscript for speed-first users.
+## tinyShield
 
-Subscription URL: https://cdn.jsdelivr.net/npm/@list-kr/tinyshield@latest/dist/tinyShield.user.js
+[![jsdelivr stat](https://data.jsdelivr.com/v1/package/npm/@list-kr/tinyshield/badge)](https://www.jsdelivr.com/package/npm/@list-kr/tinyshield)
+
+tinyShield blocks Ad-Shield advertisement and anti-adblock script.
+
+tinyShield userscript is managed by the adblock community and AdGuard.
+
+> [!IMPORTANT]
+> tinyShield userscript maintainer recommends using one of the following adblockers with tinyShield userscript:
+> - AdGuard
+> - uBlock Origin
+> - Brave web browser's Shield
+> - AdBlock Plus
+> - Ghostery
+>
+> Supporting other adblockers is not guaranteed.
+
+### Quick Start
+Just click the following URL to detect this userscript.
+
+https://cdn.jsdelivr.net/npm/@list-kr/tinyshield@latest/dist/tinyShield.user.js
+
+### How to install
+- [Violentmonkey](https://addons.mozilla.org/en-US/firefox/addon/violentmonkey/) (Recommended if you cannot access AdGuard Premium) - Browser extension
+    1. Open `Dashboard`.
+    2. Click `New` button.
+    3. Click `Install from URL` button.
+    4. Input the following URL:
+    ```
+    https://cdn.jsdelivr.net/npm/@list-kr/tinyshield@latest/dist/tinyShield.user.js
+    ```
+    5. Click `OK` button.
+    6. Confirm metadata of the userscript and click `Confirm installation`.
+    7. Return to a tab opening the website protected by Ad-Shield and reload the tab by pressing <kbd>F5</kbd> or <kbd>Ctrl</kbd> + <kbd>R</kbd> or clicking the reload button.
+
+- [Tampermonkey](https://addons.mozilla.org/en-US/firefox/addon/tampermonkey/) - Browser extension
+    1. Open settings of Tampermonkey.
+    2. Go to `Utilities` tab.
+    3. Input the following URL into `Install from URL`:
+        ```
+        https://cdn.jsdelivr.net/npm/@list-kr/tinyshield@latest/dist/tinyShield.user.js
+        ```
+    4. Click `Install` button.
+    5. Confirm metadata of the userscript and click `Install`.
+    6. Return to a tab opening the website protected by Ad-Shield and reload the tab by pressing <kbd>F5</kbd> or <kbd>Ctrl</kbd> + <kbd>R</kbd> or clicking the reload button.
+
+    <details>
+    <summary>Compatibility Table</summary>
+
+    Browser Extension | License | Status
+    ----------------- | ------ | -------
+    [Tampermonkey](https://www.tampermonkey.net/) | Proprietary (Donationware) | ✔
+    [Greasemonkey](https://www.greasespot.net/) | MIT | ✘
+    [Violentmonkey](https://violentmonkey.github.io/) | MIT | ✔
+
+    </details>
+    
+- AdGuard for Windows
+    1. Click `Settings`.
+    2. Click `Extensions`.
+    3. Click `Add extension`.
+    4. Input the following URL:
+        ```
+        https://cdn.jsdelivr.net/npm/@list-kr/tinyshield@latest/dist/tinyShield.user.js
+        ```
+    5. Click `Install`.
+    6. Confirm metadata of the userscript and click `Install`.
+    7. Return to a tab opening the website protected by Ad-Shield and reload the tab by pressing <kbd>F5</kbd> or <kbd>Ctrl</kbd> + <kbd>R</kbd> or clicking the reload button.
+
+
+- AdGuard for Android
+    1. Go to Settings -> Extension.
+    2. Touch `New extension`.
+    3. Input the following URL:
+        ```
+        https://cdn.jsdelivr.net/npm/@list-kr/tinyshield@latest/dist/tinyShield.user.js
+        ```
+    4. Touch `Next`.
+    5. Confirm metadata of the userscript and touch `Add`.
+    6. Return to a tab opening the website protected by Ad-Shield and reload the tab by touching the reload button.
+
+
+ - AdGuard for iOS
+
+    Userscript is not supported currently on AdGuard for iOS.
+    However, It will be supported in the future.[^1]
+    
+    Of course, you can use an alternative temporally.[^2][^3]
+
+
+[^1]: https://github.com/AdguardTeam/AdguardForiOS/issues/1542
+[^2]: https://github.com/quoid/userscripts
+[^3]: https://apps.apple.com/us/app/userscripts/id1463298887