@@ -12,63 +14,56 @@
-# NextCloud Cookbook
-
-
+
+
](https://f-droid.org/en/packages/de.micmun.android.nextcloudcookbook/) [
](https://play.google.com/store/apps/details?id=de.micmun.android.nextcloudcookbook&hl=en_US&gl=US&pcampaignid=pcampaignidMKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1/)
+The app works generally in any modern browser. Additionally, there are some more specialized clients available, including mobile apps for Android and iOS. You can find an overview [here](docs/user/clients/Index.md).
-[Nextcloud Cookbook](https://github.com/Teifun2/nextcloud-cookbook-flutter) (by Teifun2)
-[](https://f-droid.org/en/packages/com.nextcloud_cookbook_flutter/) [](https://play.google.com/store/apps/details?id=com.nextcloud_cookbook_flutter&hl=en_US&gl=US) [](https://play.google.com/store/apps/details?id=org.capacitor.cookbook.app)
+## 💼 Is it Production Ready?
-[Nextcloud Cookbook](https://lneugebauer.github.io/nextcloud-cookbook/) (by lneugebauer)
-[](https://f-droid.org/packages/de.lukasneugebauer.nextcloudcookbook/) [
](https://play.google.com/store/apps/details?id=de.lukasneugebauer.nextcloudcookbook)
+> ⚠️ **IMPORTANT** ⚠️
+> Users of this app are practically testers. We're limited on resources and still working out how to make this app function the best it can. There will be regressions and bugs. And we of course appreciate constructive feedback whenever users run into them.
-[Cookbook Client](https://github.com/VincentMeilinger/Nextcloud-Cookbook-iOS/)
-[
](https://www.blackfire.io)
-## Sponsoring
+[
](https://www.browserstack.com/)
-We thank the sponsrs of this project for their support as open source software.
+## 📖 F.A.Q.
-### Blackfire
-[](https://www.blackfire.io)
+
+ ](https://www.browserstack.com/)
+Recipes are only shown in the UI if they are present in the database. It is likely you have recipes that haven't been indexed/added to the database yet. Try clicking the Settings > Rescan library button to compare the database with what is in your recipes folder and apply any differences to the database.
-## F.A.Q.
+If this still doesn't work, a full, non-incremental resync might help. This can be done by setting your recipes folder to a different (ideally empty) folder to clear the database. Setting the recipes folder back to what it was before should cause all your recipes to sync again, effectively refreshing the database.
+
-#### I can't see my recipes
-Recipes are only shown in the UI if they are present in the database. It is likely you have recipes that haven't been indexed/added to the database yet. Try clicking the Settings > Rescan library button to compare the database with what is in your recipes folder and apply any differences to the database.
+I can't see my recipes
-### Browser Stack -[](https://www.browserstack.com/)
+Recipes are only shown in the UI if they are present in the database. It is likely you have recipes that haven't been indexed/added to the database yet. Try clicking the Settings > Rescan library button to compare the database with what is in your recipes folder and apply any differences to the database.
-## F.A.Q.
+If this still doesn't work, a full, non-incremental resync might help. This can be done by setting your recipes folder to a different (ideally empty) folder to clear the database. Setting the recipes folder back to what it was before should cause all your recipes to sync again, effectively refreshing the database.
+
+
-#### A website using correct schema.org markup is not being read correctly
+"Could not load recipe" when trying to download recipes?
-If this still doesnt work, a full, non-incremental resync might help. This can be done by setting your recipes folder to a different (ideally empty) folder to clear the database. Setting the recipes folder back to what it was before should cause all your recipes to sync again, effectively refreshing the database - -#### "Could not load recipe" when trying to download recipes? A lot of websites are unfortunately not following the schema.org/Recipe standard, which makes their recipes impossible to read by this app. +
+
-#### All of the text is in English?
-This app uses the [Transifex](https://app.transifex.com/nextcloud/nextcloud/cookbook/) translation system.
+A website using correct schema.org markup is not being read correctly
The parser is far from perfect. If you can help out in any way, please [have a look at the parseRecipeHtml() method](https://github.com/nextcloud/nextcloud-cookbook/blob/master/lib/Service/RecipeService.php) and create a pull request with your changes. +
+
diff --git a/docs/user/clients/Index.md b/docs/user/clients/Index.md
new file mode 100644
index 00000000..f4e43fc2
--- /dev/null
+++ b/docs/user/clients/Index.md
@@ -0,0 +1,51 @@
+## Clients
+
+The app works generally in any modern browser. Additionally, there are some more specialized clients available, including mobile apps for Android and iOS..
+
+## 📱 Mobile Applications
+The currently available clients are in no particular order:
+
+| Name | Author | Sources |
+|------------------------------------------------------|----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| [Nextcloud Cookbook][micmun-nextcloud-cookbook] | [MicMun][micmun] | [All of the text is in English?
+ This app uses the [Transifex](https://app.transifex.com/nextcloud/nextcloud/cookbook/) translation system. You might want to register there to help translating the app to new languages or report errors in existing translations. +
][micmun-nextcloud-cookbook-fdroid] [
][micmun-nextcloud-cookbook-play-store] |
+| [Nextcloud Cookbook][teifun2-nextcloud-cookbook] | [Teifun2][teifun2] | [][teifun2-nextcloud-cookbook-fdroid] [][teifun2-nextcloud-cookbook-play-store] [
][teifun2-nextcloud-cookbook-ios-app-store] |
+| Nook | | [][nook-play-store] |
+| [Nextcloud Cookbook][lneugebauer-nextcloud-cookbook] | [lneugebauer][] | [][lneugebauer-nextcloud-cookbook-fdroid] [][lneugebauer-nextcloud-cookbook-play-store] |
+| [Cookbook Client][teifun2-nextcloud-cookbook] | [VincentMeilinger][] | [][teifun2-nextcloud-cookbook-ios-app-store] |
+
+
+
+
+
+[micmun]: