helpSavannah Administration - Support: sr #110333, Add instructions for setting...

 
 

sr #110333: Add instructions for setting notifications

Submitted by:  Tristan Miller <psychonaut>
Submitted on:  Mon 19 Oct 2020 07:34:54 AM UTC  
 
Category:  None Priority:  5 - Normal
Severity:  3 - Normal Status:  None
Assigned to:  None Operating System:  None
Open/Closed:  Open

Add a New Comment (Rich Markup)
   

You are not logged in

Please log in, so followups can be emailed to you.

 

Mon 19 Oct 2020 07:47:34 AM UTC, comment #1: 

From reading the Savane source code in frontend/php/include/trackers/data.php, I can see that explanatory texts are indeed available for each field, though these are printed only when the variable $show_intro_msg is nonzero.  From glancing at the rest of the code and the online interface I can't tell what UI feature sets this variable so that the messages become visible.

Tristan Miller <psychonaut>
Mon 19 Oct 2020 07:34:54 AM UTC, original submission:  

The "Set Notifications" page of a given project contains various fields but no indication as to what they are for or what values they expect.  I couldn't find this information in the documentation either.  Even if I have overlooked the documentation (in which case, please point it out to me), I suggest that the actual notification page be improved as follows:

1. The page has several <h2> headings of the form "XXX Email Notification Settings", each followed by a text field and a checkbox.  By default the field seems to be populated with a username.  I assume that this is a list of usernames that receive notifications for the particular feature, though I shouldn't have to make this assumption.  Perhaps the headings should be changed so that they explicitly state the purpose of the field (e.g., "Users Receiving XXX Notifications").

2. For these same "Notification Settings" fields, there is no indication of the field format.  Is it even possible to have more than one username there? If so, what is the delimiter?  This should be documented near the field itself (e.g., "Separate multiple usernames with commas.")  If it's not possible to add or change a username (other than one's own), then why use an input field at all?

3. For these same "Notification Settings" fields, what is the checkbox for?  Does this turn notifications on and off for all the users? If so, this should be documented on this page by adding a label next to the checkbox (e.g., "Notifications enabled") and/or by adding a tooltip to it.

4. The page contains several <h2> headings titled "Private items exclude list".  Why do all these headings have exactly the same name?  If each of them is specific to a feature, then this should be part of the title: "Task Tracker Private Items Exclude List", etc.  Alternatively, there could be a single <h2> heading naming each feature (e.g., "Task Tracker Settings"), and then generic <h3> below it (e.g., "Users Receiving Notifications", "Private Items Exclude List").

5. These "Private items exclude list" all contain an input field.  What is it for?  Also usernames?  If so, the same UI/documentation improvements described above should be applied to it.

6. The page contains a "Reminders" heading with the text, "You can configure the project so that reminder emails get sent to project members who have opened items with priority higher than 5 assigned to them."  But the text never explains how or where the user can configure the project this way.  Is the "Frequency of reminders" setting meant to be this configuration setting?  If so, then the text should be changed to "Here you can configure the project..."

Tristan Miller <psychonaut>

 

(Note: upload size limit is set to 16384 kB, after insertion of the required escape characters.)

Attach Files:
   
   
Comment:
   

No files currently attached

 

Depends on the following items: None found

Items that depend on this one: None found

 

Carbon-Copy List
  • -email is unavailable- added by psychonaut (Submitted the item)
  •  

    Do you think this task is very important?
    If so, you can add your encouragement to it.
    This task has 0 encouragements so far.

    Only logged-in users can vote.

     

     

     

    No changes have been made to this item

    Back to the top


    Powered by Savane 3.5