On 12/02/2017 04:23 AM, Luca Toscano wrote:
Hi Rich,
2017-11-28 17:06 GMT+01:00 Stefan Eissing <stefan.eiss...@greenbytes.de
<mailto:stefan.eiss...@greenbytes.de>>:
> Am 28.11.2017 um 16:40 schrieb Rich Bowen <rbo...@rcbowen.com
<mailto:rbo...@rcbowen.com>>:
> Related: I also would like to question the wisdom of having a ManagedDomain
directive and a <ManagedDomain> container. This will most assuredly lead to user
confusion and lengthy IRC conversations. I would request that the naming of one of these
directives be reconsidered. (No, I'm not suggesting anything. I suck at naming things.)
I concur that you have more experience in supporting httpd users
than myself. Personally, I do like it obviously.
I am really interested to follow up this topic, it seems really
important before moving mod_md to 2.4. What are the use cases that you
have in mind about users getting confused? The first one that comes up
in my mind is somebody looking for "ManagedDomain" on a search engine
and clicking on the <ManagedDomain> link, ending up thinking that only
that one exists.
That is exactly the scenario that I had in mind.
And I can see how this might turn up to be a IRC
nightmare, but maybe it could be resolved with good documentation? I
It's certainly possible that we can resolve this with good
documentation. However, there's always third-party "documentation" and
forum advice.
have in mind some changes to add warnings in both directives, stating
very clearly in each one that the other one also exists, but I am not
sure how well this solution could solve the issue.
The other risk that I can see having something like ManagedDomain and
<ManagedDomainDefine> (or whatever name we choose) is that users will
get confused while trying to figure out what are the differences between
the two, ending up in IRC again :D
I would also like to get feedback from other people involved in users
support on IRC if possible, this is the right moment to get some wisdom
from them.
Thanks a lot Rich for bringing up this subject!
Yeah, I don't feel so strongly about it that I'd want to force my
opinion down anybody's throat. I know, too, that naming things
"intuitively" is very, very hard.