<div dir="ltr">Dear folks<div><br></div><div>I'm asked for how to reply to a review comment on Gerrit, and here's the procedure.</div><div><ol><li>Go to your Gerrit Change. The URI should look like <a href="http://gerrit.named-data.net/#/c/NN/">http://gerrit.named-data.net/#/c/NN/</a> where NN is the Change number.</li><li>Under "History" pane, tap "Expand All" button.</li><li>Find the comment you want to reply to, and tap the line number to the left of that comment. This should display the file along with all comments.</li><li>Find the comment, tap on the comment to expand it.</li><li>Tap "Reply" button.</li><li>In the multi-line textbox, enter your reply.</li><li>Tap "Save" button. You can see that your reply is labelled "Draft", and at this moment only you can see it.</li><li>Tap the up arrow on top-right corner under your name and photo. This takes you back to the Change.</li><li>Repeat steps 2-8 if you need to reply to other comments.</li><li>Tap "Reply..." button on top-center of the screen. A popup appears with a multi-line textbox on the top, and the list of your replies in the middle. Look through your replies and verify they are all accurate and display correctly. If you need to correct a mistake, tap the line number to the left of your reply, and repeat steps 4-10. If you need to delete a reply, tap "Discard" button instead of "Save" in step 7.</li><li>If you want to write something that is applicable to the entire Change but not a specific file, you may write it on the multi-line textbox under "Reply..." button.</li><li>After reviewing all your replies, tap "Post" button. Your replies are visible to other users only after "Post".</li></ol></div><div>Many developers make the mistake of stopping at step 7, and thus their replies aren't visible to others.</div><div><br></div><div>Gerrit comments do not use Markdown syntax, and I don't have a good documentation on what's the syntax.</div><div>Some common structures can be written as:</div><div><ul><li>To embed code in your comment, put two spaces in front of each line, and put a blank line before and after the code block.<br></li><li>To create an unordered list, put a "*" in front of each line, and put a blank line before and after the list.</li><li>Gerrit syntax does not seem to support ordered lists. To create an ordered list, use the unordered list structure, and put the number inside the list. In other words, the first item should start with "* 1.", the second item should start with "* 2.", etc.</li></ul></div><div>Gerrit discussion should focus on the code itself. If you need to discuss design, post such discussions to Redmine, where every post gets a "note-N" link so it can be referenced easily.</div><div><br></div><div>This article is part of "HOWTOs for n00b" series. You may find other articles in this series on <a href="http://redmine.named-data.net/projects/nfd/wiki">NFD wiki</a> under developer resources.</div><div>Yours, Junxiao</div></div>