Content updates (#269)

keunes · ByteHamster · web-flow · commit 64172847a57d · 2023-08-29T08:46:04.000+02:00
* Text updates for documentation &amp; general pages
* Indent improvements
* Add documentation page on other platforms

---------

Co-authored-by: ByteHamster &lt;ByteHamster@users.noreply.github.com&gt;
diff --git a/_documentation/general/other-platforms.md b/_documentation/general/other-platforms.md
@@ -0,0 +1,11 @@
+---
+title: documentation.categories.general.other-platforms
+layout: doc
+level: "2"
+group: "general"
+icon: "fa-solid fa-apple-alt"
+---
+
+# {% t {{ page.title }} %}
+
+{% tf documentation/{{ page.group }}/{{ page.slug }}.md %}
diff --git a/_i18n/en.yml b/_i18n/en.yml
@@ -142,6 +142,7 @@ documentation:
       proxy: "Leading traffic through a proxy or Tor network"
       episode-deletion: "Deletion of episodes"
       f-droid: "Updates on F-Droid"
+      other-platforms: "AntennaPod for Windows, Apple and Linux"
     playback:
       title: "Playback"
       intro: "Below, you can find topics related to playback."
diff --git a/_i18n/en/contribute/translate.md b/_i18n/en/contribute/translate.md
@@ -58,7 +58,7 @@ In the AntennaPod project, you will find four 'components'. Each represents a pa
 New translations are pulled from Weblate to GitHub (the development platform) manually once in a while. When a language hits 90% translation (that's roughly the whole website minus the Contribute section), we can enable it on the live website. We always try to find a community member that can review a test version of the website, to improve the quality of translations.
 
 # Other materials
-In addition to the app and website, also the images in the app stores can be translated. They have screenshots and texts. Because there is very limited space we use a manual process with trial and error. Please let us know on the forum if you want to help with that. Because localised app store listings are more likely to be downloaded, help is very much welcome!
+In addition to the app and website, also the images in the app stores can be translated. They have screenshots and texts. Because there is very limited space we use a manual process with trial and error. Please let us know on the forum if you want to help with that. Because localized app store listings are more likely to be downloaded, help is very much welcome!
 
 # Get in touch!
 * Do you want to give **feedback** on the English texts or any of the translations? 
diff --git a/_i18n/en/documentation/bugs-first-aid/database-error.md b/_i18n/en/documentation/bugs-first-aid/database-error.md
@@ -1,6 +1,8 @@
 You might feel like screaming *Help! I lost my podcasts/episodes/settings/everything!*
 
-The problem is that in a very old AntennaPod version, the database with all information (episodes, listening states, etc) had some problems. While the problems are long fixed, they might have left your database in a state that works but is slightly corrupted. With that corrupted database, the problem can manifest even in more recent versions if they happen to write to the corrupted parts (eg. during an update). If this happens, AntennaPod cannot function with the broken database and has to start over with an empty one. We realise it is very frustrating when this happens and are really sorry if you were affected.
+In a very old AntennaPod version, there were some issues with the database with all information (episodes, listening states, etc). While the cause is long fixed, your database might have been damaged (even when the app was working without issues). If a recent AntennaPod version makes changes to the damaged parts of the database, these damages may suddenly become a problem. At that point AntennaPod can no longer work with the broken database and has to start over with an empty one.
+
+We realize it is very frustrating when this happens and are really sorry if you were affected.
 
 There may be some things you can do to recover your data. We list them below, starting with the solution that gives the easiest & best results:
 
diff --git a/_i18n/en/documentation/general/f-droid.md b/_i18n/en/documentation/general/f-droid.md
@@ -1,10 +1,18 @@
-After a new version of AntennaPod gets released, we often are asked when it will be available on F-Droid. We can't give an exact answer — it usually takes a few days.
+Did you see that there's a new AntennaPod release and wonder:
+* _why isn't the latest version not on F-Droid yet?_
+* _when will the new release be available on F-Droid?_
 
-Getting a new version on F-Droid involves the following steps:
+If the new version is in beta, it is _only_ available through Google Play ((here is why)[/documentation/general/beta]). When we think it's ready we upload it to Google Play. A few days later, when we're confident there are no critical bugs, we tag the release on GitHub. F-Droid then has to find out about this release, build it and make it available. All these steps may take some time.
+Due to the different steps and because we are not involved in publishing releases on F-Droid, we can't tell when exactly the latest version will be available there. It usually takes a few days after the release is tagged on GitHub.
+
+In short: it may take some time. Please be patient.
+
+### The steps of getting a new version on F-Droid
 - After we create a [release](https://github.com/AntennaPod/AntennaPod/releases), F-Droid needs to detect that something in AntennaPod changed. For this, F-Droid runs an update checker server about every 2 days.
 - After F-Droid detects that there is a new AntennaPod release, it builds the app. With this, F-Droid makes sure that the app you download really matches the source code that AntennaPod publishes. Because there are many apps to build, the F-Droid server takes an additional 1-2 days to build the app.
 - Finally, the resulting app needs to get signed cryptographically. This happens on a computer that is not connected to the internet. A person at F-Droid needs to take the app and physically walk it to that special computer. How long this takes depends on how often the person walks to that special computer. Usually, this step takes an additional 1-2 days after the app was built.
 
-As you can see it can easily take a week before a new AntennaPod release is available on F-Droid, so please be patient. If an update is still not available more than a week after its release, feel free to let us know by creating a post on our [forum](https://forum.antennapod.org/), and we'll investigate it.
+### What you can do if it takes longer than expected
+As you can see it can easily take a week before a new AntennaPod release is available on F-Droid. If an update is still not available more than a week after its release, feel free to let us know by creating a post on our [forum](https://forum.antennapod.org/), and we'll investigate it.
 
 You can get an idea of the progress by checking [if F-Droid's releases list was updated](https://gitlab.com/fdroid/fdroiddata/-/commits/master?search=Update+known+apks) since the new AntennaPod release and by checking on [F-Droid Monitor](https://monitor.f-droid.org/builds/build) if the new release was built yet.
diff --git a/_i18n/en/documentation/general/other-platforms.md b/_i18n/en/documentation/general/other-platforms.md
@@ -0,0 +1,21 @@
+However attractive the title may sound, AntennaPod is not and will not be available on Windows, iOS or the Linux desktop. The app is made by a small team of volunteers, and making the app for these other platforms would be a lot of work.
+
+There are (open source) alternatives, however, which we would like to point you to:
+
+<!-- mdpo-disable -->
+<!-- mdpo-enable-next-line -->
+
+App|Code|iOS|MacOS|Windows|Linux
+---|---|---|---|---|---
+[Podverse](https://podverse.fm/about)|[<i class="fab fa-github"></i>](https://github.com/podverse/podverse-rn)|✅|✅|❌|❌
+[Pocket Casts](https://pocketcasts.com/)|[<i class="fab fa-github"></i>](https://github.com/Automattic/pocket-casts-ios)|✅|❌|❌|❌
+[gPodder](https://gpodder.github.io/)|[<i class="fab fa-github"></i>](https://github.com/gpodder/gpodder)|❌|✅|✅|✅
+[Poddr](https://sn8z.github.io/Poddr/)|[<i class="fab fa-github"></i>](https://github.com/Sn8z/Poddr)|❌|✅|✅|✅
+[Kasts](https://apps.kde.org/kasts/)|[<i class="fab fa-gitlab"></i>](https://invent.kde.org/multimedia/kasts)|❌|❌|❌|✅
+[Vocal](https://vocalproject.net/)|[<i class="fab fa-github"></i>](https://github.com/VocalPodcastProject/vocal)|❌|❌|❌|✅
+[GNOME Podcasts](https://apps.gnome.org/app/org.gnome.Podcasts/)|[<i class="fab fa-gitlab"></i>](https://gitlab.gnome.org/World/podcasts)|❌|❌|❌|✅
+[MusicPod](https://snapcraft.io/musicpod)|[<i class="fab fa-github"></i>](https://github.com/ubuntu-flutter-community/musicpod)|❌|❌|❌|✅
+
+<!-- mdpo-enable -->
+
+Do you have a recommendation of an open source podcast app for these platforms? [Let us know on the forum!](https://forum.antennapod.org)
diff --git a/_i18n/en/documentation/general/synchronization.md b/_i18n/en/documentation/general/synchronization.md
@@ -41,11 +41,11 @@ AntennaPod can synchronise your subscriptions and listening progress with other
 ## Enable synchronization via gPodder
 1. Create an account on the server www.gpodder.net or on your own server
 2. When you have an account, log in on the webserver and create a device under `Subscriptions` » `Devices` for each client that you use:
-    <!-- mdpo-disable-next-line -->
-    <br />{{ img-devices | strip }}
+   <!-- mdpo-disable-next-line -->
+   <br />{{ img-devices | strip }}
 3. When you have added the devices to your account, link them using the "Configure" button. This way, gpodder.net automatically keeps the activated devices synchronized.
-  <!-- mdpo-disable-next-line -->
-  <br />{{ img-synchronize | strip }}
+   <!-- mdpo-disable-next-line -->
+   <br />{{ img-synchronize | strip }}
 4. Go to `Settings` » `Synchronization` in AntennaPod and tap `Choose synchronization provider`
 5. Select 'gPodder'
 6. Enter the 'Server address' (e.g. www.gpodder.net) and tap `Proceed to login`
