zopefoundation / Products.MailHost

zope.sendmail integration for Zope.
Other
2 stars 7 forks source link

Improve help text for `Maildir folder` #24

Open jugmac00 opened 4 years ago

jugmac00 commented 4 years ago

When your Queue directory is misconfigured, you see two messages in ZMI.

  1. This must be a Maildir folder directly below the input field
  2. n/a - /chosen/path/to/mailhost is not a maildir - please verify your configuration at the bottom of the page

I'd like to improve the wording and maybe also the exception handling, as the message is not really clear and possibly suggests you would have to know how to create a valid Maildir folder (with the typical subfolders yourself.

The new text should mention that the directory gets created automatically (as far as I remember) as long as you choose an existing path but a name for a directory which not exists. Ie when /srv/spool exists you can enter /srv/spool/maildir but not /srv/spool/a/maildir.

If nobody pushes to the front, I'd like to go for it - in the new year, though.

Opinions?

dataflake commented 4 years ago

I am in the code right now and will incorporate several improvements to that page. As I want to create a MailHost release I will close this issue afterwards. Please reopen or create a new issue if there's still a problem.

jugmac00 commented 4 years ago

With @dataflake 's changes applied, and when you enter an invalid directory path and hit "Save Changes"...

Some thoughts: