On Sat, 2005-03-26 at 14:39, Radu Hociung wrote:
I would suggest that will people come to this document with two
questions in mind:
1. What is SPF and what's in it for me ?
2. What should _I_ publish?
I would structure it like so:
- Introduction
Explains what SPF is, why is it needed, and who needs it.
- Typical use scenarios
Yes, this is what I was targeting. I was thinking the information would
be arranged, in the typical use scenarios, as:
I'm a home user who has their own domain for vanity or business
purposes and I only use email when at home. My connection to
the Internet is through the monopoly cable provider in my area.
I have configured my email client using the instructions
provided by my ISP and had to tell my email application my
username and password for my ISP. How should I configure my SPF
record?
The SPF record for your domain should be
"v=spf1 mx:isp.com ~all"
because ....
I want to arrange the "question" part with the way non-technical people
would talk about it. That is "tell my email application my username and
password for my ISP" implies SMTP AUTH without having to use confusing
acronyms. These assumptions would be explained in the "because ..."
portion of the "answer". A key could also be provided early on ("if you
have to tell your email program your username and password in order to
send email, then you are using SMTP AUTH"). This way, it makes it
easier after reading a few of them to hone in on the exact configuration
you want and be able to determine which scenario applies to you.
The document's table of contents could be arrange in such a way as to
make it easy to find the group of scenarios that apply to you without
having to read the entire document.
--
Andy Bakun <spf(_at_)leave-it-to-grace(_dot_)com>