Support Ticketing
Platform specific steps
Ticketing tips
Good tickets are
- Reproducible
- Limited in scope to the issue at hand
- Informational
I.e., someone unfamiliar with the project can ascertain the issue you are having, or the feature you desire. "I am attempting to do X on page (link), I have tried to do Y, but am seeing Z (screenshot) instead of the desired result."
Good tickets contain
- Links and error messages
- Relevant corresponding files, including: screenshots, design mockups, SOW, etc.
- Steps to replicate the issue
- Potential fixes to resolve it
Before creating a ticket
Ask yourself
- Does the request, as it came from the client, make sense to me?
- Is the client actively participating in this discussion?
- Is there a clear ask, or do we need to refine?
- Can I recreate the issue?
- Are there related tickets? OR
- Has this come up before?
- What are the budget / timeline constraints?
Does the developer
- Need time to set up local environments or get familiar with the project?
- Have the access needed to assess the issue? (Servers, Valid Passwords in Vault)
- Have the access needed to fix the issue? (UMD, JHU, Howard University, etc.)
Before starting a ticket
Ask yourself
- Do I have the information, tools, context and access I need?
- Are there any older tickets related to this issue?
- Is this a bug or a feature request?
- Is there a better solution to the problem? a.k.a., What really is the problem here?
Tickets may inspire
- Discussions about IA and Design
- Widgets, Layout Updates
- Larger implications on the site environment APIs, Styles and Themes
- Alterations to legacy sites
- Discussions on scope and budget. Not "can we do this" but "should we do this"
Before a ticket is considered ready for QC
Ask yourself
- What is the QC, approval and deployment process for this project?
- Does the client need to review and approve an update?
- Have I included a link for stakeholders (PMs/clients/designers) to view the fix?
- Are the caches cleared?
- What else needs to run in order to see the updates?
- Do I need to provide further context on how to review the update?
- Have I created Test content that needs to be deleted later?
Have I documented
- The fix I enacted, in broad strokes, so another developer:
- Understands what is going on?
- Can modify it later, pick up the ticket, etc.?
- The full breadth of the issue and fix, in case it comes up again?
- Next steps to get this to production?
Before a ticket is closed
Ask yourself
- Have I billed this time to the proper project?
- Have I closed any hotfix branches, deleted any irrelevant tests, etc.?
- Has the client been alerted, and signed off on the task?
- Does this ticket have any future implications that need to be addressed?