search

cscarney / syndic

Convergent feed reader for Plasma and Android
12 stars 2 forks source link

Add explanation to "Download web content for offline viewing" tooltip #232

Open plata opened 2 months ago

plata commented 2 months ago

What does this general setting do? How does it relate to the per feed setting?

Background: I activated the general setting and then wondered why the articles were not downloaded.

cscarney commented 2 months ago

The global setting changes the way the per-feed setting behaves.

The per-feed setting ("Always load web content") causes articles from that feed open directly to the web content view. This is intended for feeds that don't provide article content in the feed itself.

The global setting ("Download web content for offline viewing") causes web content to be loaded at update-time rather than on demand. This is intended for people who will be using the application offline.

With the global setting enabled, feeds that are set to use web content will request a web page for every article in the feed as part of the update process. Feeds that are not set to show web content are unaffected.

If web content isn't available at update time – if the site fails to load or the scraper doesn't find any article content – then we quietly fall back to loading it on-demand. If it fails to load on-demand then we fall back to feed content.

[5/18 edited for clarity]

plata commented 2 months ago

Can you add this information to the (i) buttons? Not everything, that would be too much. The bold part should be enough. If there's an online documentation (I don't think so?), the detailed explanation could go there.

cscarney commented 2 months ago

That's a good idea, I'll do that.

There's not currently a documentation, but I can write an article explaining how updates work and link to it.