[Bug 13349] Undraft mail notification spec

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=13349

--- Comment #32 from Simon McVittie <simon.mcvittie at collabora.co.uk> 2010-04-19 09:00:47 PDT ---
> +        such as ("Nicolas Dufresne", "nicolas.dufresne at collabora.co.uk"). At
> +        least one of name and address MUST be provided. A missing element will
> +        be represented by the empty string.
> +        <tp:rationale>
> +          It is common for IM client to behave according to the UI design.
> +          Thus, some protocol may only provides one of name or address. Also,
> +          the display name is optional in an e-mail header. The goal here is
> +          to provide all available information with the highest accuracy. This
> +          way the client code does not have to do any guessing on what the
> +          address may contain.
> +        </tp:rationale>

Please wrap the main text in <p></p> when you add a second paragraph
(tp:rationale always counts as a paragraph), and have <p></p> inside the
<tp:rationale> too (to get nice spacing). To make this work properly you might
need to add the XHTML xmlns to the <tp:docstring> (see any tp:docstring that
contains XHTML for an example).

You don't need all that rationale (and I don't understand why you need to even
mention a UI design). I'd just say something like this:

>        such as ("Nicolas Dufresne", "nicolas.dufresne at collabora.co.uk").
>        At least one of name and address MUST be provided. A missing element
>        will be represented by the empty string.</p>
>
>        <tp:rationale>
>          <p>The CM should provide as much information as possible, but not all
>            protocols provide both the displayed name and the address. (If a
>            protocol doesn't provide either, it should omit the appropriate
>            field from the <tp:type>Mail</tp:type> entirely.)</p>
>        </tp:rationale>

-- 
Configure bugmail: https://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.