DZone
Thanks for visiting DZone today,
Edit Profile
  • Manage Email Subscriptions
  • How to Post to DZone
  • Article Submission Guidelines
Sign Out View Profile
  • Post an Article
  • Manage My Drafts
Over 2 million developers have joined DZone.
Log In / Join
Refcards Trend Reports Events Over 2 million developers have joined DZone. Join Today! Thanks for visiting DZone today,
Edit Profile Manage Email Subscriptions Moderation Admin Console How to Post to DZone Article Submission Guidelines
View Profile
Sign Out
Refcards
Trend Reports
Events
Zones
Culture and Methodologies Agile Career Development Methodologies Team Management
Data Engineering AI/ML Big Data Data Databases IoT
Software Design and Architecture Cloud Architecture Containers Integration Microservices Performance Security
Coding Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Partner Zones AWS Cloud
by AWS Developer Relations
Culture and Methodologies
Agile Career Development Methodologies Team Management
Data Engineering
AI/ML Big Data Data Databases IoT
Software Design and Architecture
Cloud Architecture Containers Integration Microservices Performance Security
Coding
Frameworks Java JavaScript Languages Tools
Testing, Deployment, and Maintenance
Deployment DevOps and CI/CD Maintenance Monitoring and Observability Testing, Tools, and Frameworks
Partner Zones
AWS Cloud
by AWS Developer Relations
The Latest "Software Integration: The Intersection of APIs, Microservices, and Cloud-Based Systems" Trend Report
Get the report
  1. DZone
  2. Testing, Deployment, and Maintenance
  3. Deployment
  4. Jira Best Practices From Experts

Jira Best Practices From Experts

In this article, readers will learn about the best practices in Jira we've found useful while developing software for clients as well as our own products.

Oleksandr Siryi user avatar by
Oleksandr Siryi
·
Feb. 23, 23 · Opinion
Like (2)
Save
Tweet
Share
4.17K Views

Join the DZone community and get the full member experience.

Join For Free

Railsware is an engineer-led company with a vast portfolio of building projects for companies, so when talking about Jira best practices for developers, we speak from experience.

Why Do People Love Jira?

Jira is by no means perfect. It certainly has its downsides and drawbacks. For instance, it is a behemoth of a product and, as such, is pretty slow when it comes to updates or additions of new functionality.

Some developers also say that Jira goes against certain agile principles because—when in the wrong hands—it can promote fixation on due dates rather than delivery of product value. Getting lost in layers and levels of several boards can, indeed, disconnect people by overcomplicating things. 

Still, it is among the preferred project management tools among software development teams. Why is that? 

  • Permissions: Teams, especially bigger ones, work with many different experts and stakeholders, besides the core team itself. So, setting up the right access to information is crucial. 
  • Roadmaps and epics: Jira is great for organizing your project on all levels. On the highest level, you have a roadmap with a timeline. Then, you have epics that group tasks by features or feature versions. Inside each epic, you create tickets for implementation.
  • Customization: This is Jira’s strongest point. You can customize virtually anything:
    • Fields for your JIRA tickets.
    • UI of your tickets, boards, roadmaps, etc.
    • Notifications.
    • Workflows: Each project may require its own workflow and set of statuses per ticket, e.g., some projects have staging server and QA testing on it and some don’t.
  • Search is unrivalled (if you know SQL aka JQL in Jira): Finding something that would have been lost to history in a different project management tool is a matter of knowing JQL in Jira. The ability to add labels using keywords makes the aforementioned search and analysis even simpler. 
  • Automation: The ability to automate many actions is among the greatest and most underestimated strengths of Jira:
    • You can create custom flows where tickets will create temporary assignees (like the back and forth between development and QA).
    • You can make the issue fall into certain columns on the board based on its content.
    • Move issues to “in progress” from “todo” when there’s a related commit.
    • Post the list of released tickets to Slack as a part of release notes.
  • Integrations and third party apps: Github, Bitbucket, and Slack are among the most prominent Jira integrations, and for good reasons. Creating a Jira ticket from a message, for example, is quite handy at times. The Atlassian Marketplace broadens your reach even further with thousands of add-ons and applications.
  • Broad application: Jira is suitable for both iterative and non-iterative development processes for IT and non-IT teams.

Jira Best Practices

Let’s dive into the nitty-gritty of Jira best practices for multiple projects or for a single one.

Define Your Goals and Users

Jira, being as flexible as it is, can be used in a wide manner of ways. For instance, you can primarily rely on status checking throughout the duration of your sprint, or you can use it as a project management tool on a higher level (a tool for business people to keep tabs on the development process). Define your team and goals.

Now that you have a clear understanding of why, let’s talk about the “who.” Who will be the primary Jira user? And will they be using it to:

  • Track the progress on certain tickets to know where and when to contribute?
  • Use it as a guide to learn more about the project? 
  • As a tool for tracking time for invoicing clients, performance for internal, data-driven decision making, or both?
  • Is it a means of collaborating, sharing, and spreading knowledge across several teams involved in the development of the product?

The answers to the above questions should help you define the team and goals in the context of using Jira.

Integrations, Third-Party APIs, and Plugins

Jira is a behemoth of a project management platform. And, like all behemoths, it is somewhat slow and clunky when it comes to moving forward. If there’s some functionality you feel is missing from the app—don’t shy away from the marketplace. There’s probably a solution for your pain already out there.

Our team, for instance, relies on a third-party tool to create a series of internal processes and enhance fruitful collaboration. You can use ScriptRunner to create automation that’s a bit more intricate than what comes out of the box. Or you can use BigGantt to visualize the progress in a friendly drag-and-drop interface.

Don’t shy away from combining the tools you use into a singular flow. An integration between Trello and Jira, for instance, can help several teams—like marketing and development—stay on the same page.

Use Checklists in Tickets

Having a checklist integrated into your Jira issues can help guide a culture that’s centered around structured and organized work as well as transparency and clarity to everyone. Our Smart Checklist for Jira offers even more benefits: 

  • You have a plan: Often times it’s hard to start a feature implementation, and without a plan, you can go in circles for a long time.
  • Having mental peace: Working item by item is much more calm and productive than dealing with the unknown.
  • Visibility of your work: If everyone sees the checklist progress, you are all on the same page.
  • Getting help: If your progress is visible, colleagues can give you advice on the plan itself and the items that are challenging you.
  • Prioritization: Once you have the items list, you can decide with your team what goes into v1, and what can be easily done later.
  • You can use checklists as templates for recurring processes: Definition Done, Acceptance Criteria, onboarding and service desk tickets, etc., are prime candidates for automation. 
Moreover, you can automatically add checklists to your Jira workflow based on certain triggers like the content of an issue or workflow setup. To learn more, watch our YouTube video: “How to use Smart Checklist for Jira.”

Less Is More 

Information is undoubtedly the key to success. That said, in the case of a Jira issue, awareness is key. 

What we’ve noticed over our time of experimenting with Jira is that adding more info that is either unnecessary or irrelevant seems to introduce more confusion than clarity into the process. 

Note: We don’t mean that Jira shouldn’t be used for knowledge transferring. If some information (links to documentation, your internal processes, etc.) is critical to the completion of a task—share it inside the task. Just use a bit of formatting to make it more readable.

However, an age-old history of changes or an individual’s perspective on the requirements is not needed. Stick to what is absolutely necessary for the successful completion of a task and elaborate on that. Not more, nor less.

Keep the Backlog and Requirements Healthy and Updated

Every project has a backlog—a list of ideas, implementation tickets, bugs, and enhancements to be addressed. Every project that does not keep its backlog well-maintained ends up in a pickle sooner rather than later. 

Some of our pro-tips on maintaining a healthy backlog are:

  • Gradually add the requirements to the backlog: If not for anything else, you’ll have a point of reference at all times, but moving them there immediately may cause certain issues as they may change before you are ready for implementation.
  • Keep all the work of the development team in a single backlog: Spreading yourself thin across several systems that track bugs, technical debt, UX enhancements, and requirements is a big no-no.
  • Set up a regular backlog grooming procedure: You’ll get a base plan of future activities as a result. We’d like to point out that said plan needs to remain flexible to make changes based on feedback and/or tickets from marketing, sales, and customer support. 

Have a Product Roadmap in Jira

Jira is definitely not the go-to tool for designing a product roadmap, yet having one in your instance is a major boon, because it makes the entire scope of work visible and actionable. Additional benefits of having a roadmap in Jira include:

  • It is easier to review the scope with your team at any time.
  • Prioritizing new work is simpler when you can clearly see the workload.
  • You can easily see dependencies when several teams are working on a project.

Use Projects as Templates

Setting up a new project can be tedious even if you’ve done it a million times before. This can be especially troublesome in companies that continuously deliver products with a similar approach to development such as mobile games. 

Luckily, there’s no need to do the same bit for yet another time with the right combination of tools and add-ons. A combination of DeepClone and Smart Checklist will help you clone projects, issues, stories, or workflow conditions and use them as project templates.

Add Definition of Done as a Checklist to all of Your Jira Issues

Definition of Done is a pre-release checklist of activities that determine whether a feature is “releasable.” In simpler words, it determines whether something is ready to be shipped to production. The best way of making this list accessible to everyone in the team is to put it inside the issues. You can use Smart Checklist to automate this process; however, there are certain rules of thumb you’ll need to follow to master the process of designing a good DoD checklist:

  • Your objectives must be achievable.
  • They must clearly define what you wish to deliver.
  • It’s best if you keep the tasks measurable. This will make the process of estimating work much simpler. 
  • Use plain language so everyone who is involved can easily understand the Definition of Done.
  • Make sure your criteria are testable so the QA team can make sure they are met.

Sync With the Team After Completing a Sprint

We have a nice habit of running Agile Retrospective meetings here at Railsware. These meetings, also known as Retros, are an excellent opportunity for the team to get recognition for a job well done. They can also help you come up with improvements for the next sprint. 

We found that the best way of running these meetings is to narrow the conversation to goods and improves. This way you will be able to discuss why the things that work are working for you. You’ll also be able to optimize the rest.

Conclusion

If there’s a product where there’s something for everyone—within the context of a development team—it’s probably Jira. The level of customization, adaptability, and quality of life features is an excellent choice for those teams that are willing to invest in developing a scalable and reliable process. If there’s anything missing from the app—you can easily find it on the Atlassian Marketplace.

IT Software development agile Jira (software) Sprint (software development) workflow API Best practice GitHub Software quality assurance UI backlog Interface (computing) optimization Slack (software) sql Integration

Published at DZone with permission of Oleksandr Siryi. See the original article here.

Opinions expressed by DZone contributors are their own.

Popular on DZone

  • Journey to Event Driven, Part 1: Why Event-First Programming Changes Everything
  • Important Takeaways for PostgreSQL Indexes
  • How Agile Architecture Spikes Are Used in Shift-Left BDD
  • Securing Cloud-Native Applications: Tips and Tricks for Secure Modernization

Comments

Partner Resources

X

ABOUT US

  • About DZone
  • Send feedback
  • Careers
  • Sitemap

ADVERTISE

  • Advertise with DZone

CONTRIBUTE ON DZONE

  • Article Submission Guidelines
  • Become a Contributor
  • Visit the Writers' Zone

LEGAL

  • Terms of Service
  • Privacy Policy

CONTACT US

  • 600 Park Offices Drive
  • Suite 300
  • Durham, NC 27709
  • support@dzone.com
  • +1 (919) 678-0300

Let's be friends: