CC field needs documentation on the ticket page

[ecarter]

Currently, a user looking at the ticket page is not given any information about what is supposed to go into the CC field. Many assume that you have to enter an email address even though usernames work. The choice of separator is not specified, so you get people using commas, spaces, semicolons, and probably other characters as separators.

Further, the use of semicolons appears to be partially supported by the code base; and the code for splitting this field is implemented in multiple places in notification.py.

While a complete redesign of this field is desired (#5378, #1459, etc.), it keeps getting postponed. So this should provide a significant usability improvement in the mean time.

[ecarter]

See also #899

[sid]

Note that the implementation in 0.11 changed (see #1459).

At first, I assumed you meant updating the documentation page about the CC field. But are you asking for a tooltip or something like that instead?

[anonymous]

Now that #1459 is fixed in 0.11, and there is a checkbox to add your email to the CC list instead of adding it manually, I think this issue is no longer relevant.

[cguillot@…]

Not to speak for the original poster, but I believe that a tooltip or something similar is what he was asking for. While the purpose of the cc field is fairly clear, its usage is not. The tip should explain that Trac usernames and email addresses are valid, and should give the appropriate separator.

[Dave T <davet2001@…>]

Can I reinforce the position for adding a tooltip here. I'm using trac 0.10.3, and found this page whist googling to try and figure out how to use the cc box.

Ok, so I can use either email addresses or usernames, but what *is* the separator? - I still don't know, is it space, semicolon, comma or something else?

The tickbox is a good idea.

[ecarter]

Fixed.

• 0.10-stable in r7079
• 0.11-stable in r7080
• 0.12 aka trunk in r7081