As a user or viewer of SEI widgets,
I want the ability to see the defined settings (e.g., Small, Medium, Large thresholds) as a legend directly on the widget UI,
And have an option to quickly change the values directly from the widget without needing edit access,
So that I can perform quick analysis and adjustments without navigating through multiple steps like Edit > Settings.
Acceptance Criteria:
Settings Visibility:
Display the “Options” settings (e.g., thresholds for Small, Medium, Large) as a legend on the widget UI itself.
The legend should be visible to all users, regardless of edit permissions.
Quick Edit Capability:
Allow users with appropriate permissions to quickly edit the thresholds (e.g., change Small from 50 to 40 lines of code) directly on the widget UI.
Users should see the updated metrics on the widget immediately after making changes.
Non-Editable Access for Viewers:
For users without edit access, the settings/thresholds should still be visible as a legend, but editing capability should be disabled.
Dynamic Update of Metrics:
When threshold values are changed, the widget metrics (e.g., PR Code Change Size chart) should dynamically update to reflect the new values without requiring a page reload.
User Experience:
Changes to thresholds should be intuitive (e.g., inline editing or a simple modal on click).
Ensure smooth interaction and avoid disruption to existing workflows.
Error Handling:
If a user inputs an invalid value, display an appropriate error message and do not save the changes.
Note: PR Code Change Size is an example widget I sued, but the user wants this for all widgets
Who are "they"?
The users for this feature primarily include:
L1 Managers and Team Leads:
They need to monitor key metrics and thresholds (e.g., PR size, code churn) to identify trends, anomalies, or areas needing attention quickly.
Developers:
While not primary decision-makers, developers may also want visibility into these thresholds to understand how their work is being measured and tracked.
Senior Leadership (Secondary):
Leadership may occasionally view widgets for broader insights but are not likely to edit the thresholds themselves.
What is this for?
The feature serves two purposes:
Transparency of Widget Metrics:
Users can view the defined thresholds (e.g., Small, Medium, Large PR size) directly on the widget UI as a legend.
This improves visibility into how metrics are being evaluated, ensuring alignment and clarity on what constitutes "small," "medium," or "large" contributions.
Quick Adjustments for Contextual Insights:
Users with permissions can edit thresholds directly from the widget UI without navigating through multiple steps (e.g., Edit > Settings).
This saves time and allows teams to perform quick experimentation and adjustments to thresholds based on their team’s unique context or evolving needs.
What do they get out of it?
Improved Efficiency:
Eliminates the friction of navigating multiple steps to view or adjust thresholds, streamlining workflows.
Better Context for Decision-Making:
Quick edits allow users to explore "what-if" scenarios, helping them adapt metrics to their evolving goals. For example:
Adjusting PR size thresholds to better reflect team productivity or code review efficiency.
Transparency and Alignment:
View-only users (e.g., developers or stakeholders) gain a clear understanding of how thresholds impact the insights they see, fostering alignment across teams.