From 8bde5169d17d79fdaac48d9e77c68fc946ea2234 Mon Sep 17 00:00:00 2001
From: offa <8887756+offa@users.noreply.github.com>
Date: Sun, 9 Nov 2025 14:18:44 +0000
Subject: [PATCH] Update contribution guide regarding IzzyOnDroid repo (#571)

Co-authored-by: Izzy <IzzySoft@users.noreply.github.com>
---
 CONTRIBUTING.md | 24 +++++++++++++++++++++---
 1 file changed, 21 insertions(+), 3 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index eff0749..053a93a 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -17,9 +17,27 @@ Entries are sorted alphabetically.
 
 ## F-Droid links
 
-If a package is available on [**F-Droid**](https://f-droid.org/) it can be linked using the `https://f-droid.org/app/<App ID>` URL.
+If a package is available on [**F-Droid**](https://f-droid.org/) it can be linked using the `https://f-droid.org/packages/<App ID>` URL.
 If not yet, it's a good idea to promote F-Droid submission to the projects developer.
 
-[**IzzyOnDroid**](https://apt.izzysoft.de/fdroid/) can be linked using `https://apt.izzysoft.de/fdroid/index/apk/<App ID>` only, if the package is *not* available on F-Droid and *not* marked by *NonFreeComp*.
+[**IzzyOnDroid**](https://apt.izzysoft.de/fdroid/) can be linked using `https://apt.izzysoft.de/packages/<App ID>`, if the package is *not* marked by *NonFreeComp*.
 
-Please do not submit other third party F-Droid repositories or Google Play.
+If the package is available on both, link F-Droid first, IzzyOnDroid second.
+
+*Examples:*
+
+```markdown
+# Project page only: <Project>
+* [**Example Project**](https://github.com/example/proj)
+
+# F-Droid only: <Project> <F-Droid>
+* [**Example Project**](https://github.com/example/proj) <sup>**[[F-Droid](https://f-droid.org/packages/ex.ample.proj)]**</sup>
+
+# IzzyOnDroid only: <Project> <IzzyOnDroid>
+* [**Example Project**](https://github.com/example/proj) <sup>**[[IzzyOnDroid](https://apt.izzysoft.de/packages/ex.ample.proj)]**</sup>
+
+# F-Droid and IzzyOnDroid: <Project> <F-Droid> <IzzyOnDroid>
+* [**Example Project**](https://github.com/example/proj) <sup>**[[F-Droid](https://f-droid.org/packages/ex.ample.proj)] [[IzzyOnDroid](https://apt.izzysoft.de/packages/ex.ample.proj)]**</sup>
+```
+
+Please do not submit other third party F-Droid repositories or Google Play Store.