HakiDocs

Always Comment on Jiras

Communication habit

Effective Communication

Remember that the objective of commenting on Jira stories is effective communication.

Adding comments to the Jiras is a way of communicating
the progress and status for the actual issue.

The habit of adding comments to the jira tickets
is really important for the success of the team and the current ticket.

One comment has the power to save up tons of times and energy
into something so we can focus on other things.

Commenting on Jira stories can serve multiple purposes: it helps in tracking the progress, offers a platform for clarifying doubts, provides a history of discussions for future reference, and ensures that everyone involved in the project is on the same page.

Alien Communication

If we had the possibility of contacting Aliens, adding comments would be important so they can actually understand how we think.

General Tips

  1. Tagging: Use "@" to tag people when you need their attention on a specific point.
  2. Conciseness: Be concise but clear. Avoid long paragraphs that may be hard to follow.
  3. Professionalism: Maintain a professional tone. Jira comments may be read by various stakeholders, including managers, QA engineers, and even clients.
  4. Progress Updates: Regular updates on what you've accomplished can be helpful. Example: "Completed the data collection module, moving on to data processing."
  5. Blockers: If you're blocked by an external factor or a dependency, mention it.
  6. Technical Choices: If you make an important technical decision that diverges from the original plan, mention it.

Sources