<div dir="ltr">A great question came out of a docs session today and I wanted to post this hint/tip here, and also ask a question. <div><br></div><div>Gerrit has documentation that describes how to use regular expressions to search for specific reviews. See <a href="https://review.openstack.org/Documentation/user-search.html">https://review.openstack.org/Documentation/user-search.html</a><br>

</div><div><br></div><div>One that I've found handy for docs reviews is:</div><div><dt class="" style="margin-top:1em;color:rgb(0,0,0);font-family:Times;font-size:medium">file:^<em>REGEX</em></dt><dd><div class="" style="color:rgb(0,0,0);font-family:Times;font-size:medium">

<p style="margin:0.5em 0px">Matches any change where REGEX matches a file that was affected by the change. The regular expression pattern must start with <code>^</code>. For example, to match all XML files use<code>file:^.*\.xml$</code>. The <a href="http://www.brics.dk/automaton/">dk.brics.automaton library</a> is used for the evaluation of such patterns.</p>

</div><div class="" style="color:rgb(0,0,0);font-family:Times;font-size:medium"><p style="margin:0.5em 0px">The <code>^</code> required at the beginning of the regular expression not only denotes a regular expression, but it also has the usual meaning of anchoring the match to the start of the string. To match all Java files, use <code>file:^.*\.java</code>.</p>

</div><div class=""><p style="color:rgb(0,0,0);font-family:Times;font-size:medium;margin:0.5em 0px">The entire regular expression pattern, including the <code>^</code> character, should be double quoted when using more complex construction (like ones using a bracket expression). For example, to match all XML files named like <em>name1.xml</em>, <em>name2.xml</em>, and <em>name3.xml</em> use <code>file:"^name[1-3].xml"</code>.</p>

<br><br>For example, if you want to review all RST files that are edited in a repo, log into <a href="http://review.openstack.org">review.openstack.org</a>, then go to Settings > Watched Projects. Then, on a particular project's repo, look for file:^.*\.rst.</div>

<div class=""><br></div><div class="">One example I'd like to know about -- is it possible to watch all changes to the Networking chapter in the Cloud Admin Guide in the openstack/openstack-manuals repo? This particular search didn't work for me:</div>

<div class=""><br></div><div class="">file:"section_networking-adv-config.xml" project:openstack/openstack-manuals<br></div><div class=""><br></div><div class="">nor does:</div><div class="">file:"docs/admin-guide-cloud/networking/section_networking-adv-config.xml" project:openstack/openstack-manuals<br>

</div><div class=""><br></div><div class="">Any more ideas for focusing on doc reviews in specialty areas? </div><div class="">Thanks,</div><div class="">Anne</div><div class=""><br></div></dd></div></div>