Additional thoughts:
1. Various IMAP Push options appear in several different places in the settings, both general and per account.
While I understand the logic behind how they were arranged, let me offer two use cases where a user can be confused.
i) I have things configured and Push disabled (for whatever reasons). Now, I am adding a new account where Push is possible and desired. While all the account settings are pretty much clear, it can be confusing where I'd need to enable it:
1) Settings -> Mail Receiving -> IMAP push
2) [Account] -> Options and Folders -> Account options -> IMAP Push
3) [Account] -> Options and Folders -> IMAP options -> IMAP Push session duration
4) [Account] -> Options and Folders -> Folders -> [Folder Name] => (if configured to be synced, e.g. Inbox, Drafts, ... ): "Use IMAP Push".
As I said, once I know what needs to be changed, the logic is clear. But to figure it out, you'd have to check all the options.
And there are several other place that in principle could have some relevant options, e.g.
Settings -> Mail Other -> ...
[Account] -> Special settings -> ... (e.g. "Mail receiving")
ii) I did not have Push enabled in (1-2 above), and then while configuring some folder, as in (4) above, for the particular folder, I enable "Use IMAP Push":
would that enable the other 3 options 1)-3)? -- I haven't checked, but my intuition (consistent with [but not obviously following from] what is written in "How do I enable IMAP Push" in FAQ) tells me: "no".
(If it did, then the next question would've been: "if I disabled it now, would it disable the other options back?")
But the answer is not obvious for most new users who are not familiar yet with all the settings.
In comparison, the brief explanation under (2) tells that "when the app setting is 'on'", which suggests that I need to enable that one myself. It is not obvious in ii) and iii).
======
If I may, I'd suggest that (3) and (2) are combined:
- off
- 30 min
- 1 hour
- 2 hours
I don't have a good suggestion at the moment how to resolve other concerns.
Maybe you can provide an explanation line under the option (4), e.g.
``when enabled under "Account -> Options" ''
And under the option (2), - add a line
"need to enable for each folder in folder configuration"... Or maybe that should enable it for all accounts configured to be synced automatically? (Maybe it does?-- I don't know.)
2. There are two options in the "Folders" configuration that assign the folder to be "archive".
Here is what is not obvious here: what does it do?
The FAQ (
http://www.aqua-mail.com/?page_id=227 ) has a section "Archiving messages". It is helpful but only somewhat. It references Gmail "archive". So, if one goes to learn what Gmail means by an "archive" (
https://support.google.com/mail/answer/6576?hl=en ), it is possible to extrapolate that a similar behavior can be assumed. But as you know, a standard Unix account doesn't have that concept (although Berkeley "mail" and "pine/alpine" had an option to save messages from "INBOX" to "mbox" folder/file with the similar idea).
But until I've gone through that discovery and done thinking after reading Gmail's support notes, I was confused. But I understand that it comes from my ignorance (despite my long and rather intimate experience with various flavors of Unix). So, maybe at least adding some short description of what "archive" means (for both Google and especially non-Google accounts) would be helpful.
Kostya, you can probably tell that I'd have very limited steak in the changes resulting from my suggestions (if you choose to do so): I learned about these things, and I am hoping not to forget when and if I'd need to configure things again. The main reason I spent this time and energy carefully describing and formulating my thoughts is to improve the user experience for your great app, and hopefully help you by providing a view from a viewpoint of a person who is not involved in the project as you are. (Sometimes it can be hard to realize which things are not obvious for new users, as many things seem to be obvious.)
I don't want you to feel any pressure, and you don't need to defend any of your choices. Just think about them when you get a few minutes, and I just hope you'd find this helpful.