Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


In the KIELER project we are conducting regular code reviews of (possibly) all of our sources. To make things easier, we do software assisted reviews in Crucible.

Review Scheme

Reviews are scheduled for every thursday. In the weekly KIELER meeting one author and two reviewers are chosen.

The author's job is then to do as follows:

  • Choose about four Java classes that are to be reviewed
  • Create a Review Task in Jira
  • Create a review in Crucible
  • Invite the two reviewers to the review

Now it is the reviewers's turn to perform the review:

  • Read the source code of the class files in Crucible
  • Understand the source code and the class files
  • Write a comment if there is something that needs to be improved and mark the comment as defect
  • If you want to put more emphasis in your opinion, create a corresponding Jira issue for the defect directly from Crucible
  • Write a comment if there is anything that is not understood

Review Meeting

The week after, on Thursday, the review meeting takes place. In the Meeting the following exciting things happen

  • The moderator welcomes the author and the reviewers to the meeting
  • The moderator asks for further general remarks
  • The moderator reads all comments aloud
  • If there are any questions, reviewers or the author interrupt the moderator and start discussing
  • The moderator keeps the discussion brief
  • Finally, the moderator asks if any further remarks have arisen during the review

After the Review

After the review it is up to the author to finish any tasks that have been risen

  • The author goes through all comments in Crucible and leaves a note about his decision
  • The author may schedule a followup meeting which is only held online to review for example auxiliary classes