diff --git a/pkg/de-p1st-repo/README.md b/pkg/de-p1st-repo/README.md
index 17c9a12..98146d6 100644
--- a/pkg/de-p1st-repo/README.md
+++ b/pkg/de-p1st-repo/README.md
@@ -2,7 +2,7 @@
 
 Special thanks to nachoparker for his article:
 
-* https://ownyourbits.com/2019/07/21/replicate-your-system-with-self-hosted-arch-linux-metapackages/
+* [Replicate your system with self-hosted Arch Linux metapackages](https://ownyourbits.com/2019/07/21/replicate-your-system-with-self-hosted-arch-linux-metapackages/)
 
 ## Setup
 
@@ -26,26 +26,23 @@ Server = https://arch.p1st.de
 
 ## Normal usage
 
-### Build and push
+### Check for AUR updates, build and push
 
-Build packages on local machine
+Check remote repository for AUR packages that can be updated
 
-* e.g. with `aur sync -c SOME_AUR_PACKAGE`
-
-Push new packages to remote repository
-
-* `arch-repo-push-new`
-
-### Check for AUR updates and push
-
-Check remote repository four AUR packages that can be updated
-
-* `arch-repo-vercmp`
+```shell
+arch-repo-vercmp
+```
 
 Then build those packages locally and push changes to remote repository
 
-* e.g. with `aur sync -c SOME_AUR_PACKAGE`
-* `arch-repo-push-new`
+```shell
+# build on local machine in clean chroot or with AUR helper, e.g.
+aur sync -c SOME_AUR_PACKAGE
+
+# push new packages to remote repository
+arch-repo-push-new
+```
 
 ## example output
 
@@ -91,3 +88,13 @@ de-p1st-pacman-0.0.7-2-any.pkg.tar.zst
 de-p1st-repo-0.1.1-2-any.pkg.tar.zst
 de-p1st-repo-0.1.1-3-any.pkg.tar.zst
 ```
+
+## Removing packages
+
+On your remote server:
+
+```shell
+repo-remove REMOTE_DB_NAME.db.tar.gz PKG
+rm PKG-VERSION.pkg.tar.{xz,zst}
+rm -r db/PKG/
+```