Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Troubleshooting #92

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Conversation

Matth7878
Copy link
Contributor

Add a troubleshooting page / section.
If more troubleshooting as needed in future it will be possible to create sub section. For now I think having only 1 page is sufficient.

@ByteHamster ByteHamster requested a review from keunes April 23, 2022 16:42
Copy link
Member

@ByteHamster ByteHamster left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sorry for the long delay. I somehow forgot about the website changes. This needs a bit of re-structuring because the website changed but we can work on the text first.

@keunes, what do you think about the text?

---

# Troubleshooting
This page is for problems users can face.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would address users directly, something like "This page is for common problems you might face."

# Reporting a bug or an error in translation
Refer to [this page](/documentation/general/bug-report)

# Connectivity problems : podcast not updating or episodes not downloading
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
# Connectivity problems : podcast not updating or episodes not downloading
# Connectivity problems: podcast not updating or episodes not downloading


If the problem is with episode, try to download one with your web browser. Open link like previously described. Try to find download link to copy it and paste it in URL bar to trigger episode download. You can search for "enclosure url" or "mp3" or "type=" to help locating link.

If it is not working with web browser then look on your device if there is not something interfering with network connection :
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If it is not working with web browser then look on your device if there is not something interfering with network connection :
If it is not working with web browser then look on your device if there is not something interfering with network connection:

@keunes
Copy link
Member

keunes commented Apr 24, 2022

I'm so sorry! It seems I forgot about this PR as well - and in the meantime I had created https://antennapod.org/documentation/bugs-first-aid via #138. This PR addresses 2 points in the webpage:

  • Reporting a bug or an error in translation --> Covered here: https://antennapod.org/documentation/bugs-first-aid/typo-translations
  • Connectivity problems : podcast not updating or episodes not downloading --> Partly covered on https://antennapod.org/documentation/bugs-first-aid/episodes-missing. But
    • We should take the trouble-shooting steps (basically all text below the section title) and add it to the current page.
    • I'm wondering if we should change the title of the current page ('Cannot download an episode') to something more generic ('Connectivity problems'). Or expand the existing title to include podcast refresh ('Can't download an episode/refresh a podcast'). Or maybe make a separate article for issues with podcast refresh, which could mention something about the exclamation mark that users often refer to. @ByteHamster, what do you think?

@ByteHamster
Copy link
Member

We should take the trouble-shooting steps (basically all text below the section title) and add it to the current page.

Then the url of the page should probably be called "cannot download", not "episodes missing"

something more generic ('Connectivity problems')

Seems a bit too generic to me. Users might have a hard time finding it.

Or expand the existing title to include podcast refresh ('Can't download an episode/refresh a podcast').

👍

Or maybe make a separate article for issues with podcast refresh, which could mention something about the exclamation mark that users often refer to.

Not sure if it is worth another page. I think pages that are mostly empty always look a bit weird. I would just mention it on the existing page.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants