<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Mar 31, 2015 at 12:58 AM, Andreas Jaeger <span dir="ltr"><<a href="mailto:aj@suse.com" target="_blank">aj@suse.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On 03/31/2015 03:32 AM, Anne Gentle wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Hi all,<br>
<br>
Thinking on what the criteria for the next guide to go to RST, I wanted<br>
us to consider these data points. I mentioned this need in the last doc<br>
team meeting.<br>
<br>
Our goal is to have a sense of not only "what's next" but also the<br>
ability to answer why a guide is next, especially if (since) we're<br>
crunched for time and resources.<br>
<br>
1. Number of readers based on web analytics from Google Analytics, such<br>
as unique page views per time period.<br>
2. Number of contributors in the last two releases (one calendar year of<br>
data) from Stackalytics or git.<br>
3. Ease of migration - size of guide or simplicity of guide.<br>
4. Automation efforts - what amount of the guide is auto-generated and<br>
does that make it easier to migrate what remains (or possibly more<br>
difficult).<br>
<br>
Any other criteria you can think of, just write back to the list so we<br>
can discuss further. I'm sure I haven't thought of everything so bring<br>
your data ideas.<br>
</blockquote>
<br></span>
5. Conditionals - a guide without any conditionals is easier. Getting the User Guides separated was non-trivial,<br></blockquote><div><br></div><div>Agreed, I'll come up with some measurements for "simplicity of guide" such as:</div><div> - number of outputs from single source</div><div> - number of instances of conditional text</div><div><br></div><div>There may be some other measure of simplicity/complexity such as "does it have index entries?" so keep the suggestions coming, thanks!</div><div><br></div><div>Anne</div><div>  </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<br>
Btw. let's do it slowly, we can convert one guide after the other and still have some questions to answer like how to handle the glossary,<br>
<br>
Andreas<span class="HOEnZb"><font color="#888888"><br>
-- <br>
 Andreas Jaeger aj@{<a href="http://suse.com" target="_blank">suse.com</a>,<a href="http://opensuse.org" target="_blank">opensuse.org</a>} Twitter/Identica: jaegerandi<br>
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany<br>
   GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu,<br>
       Graham Norton, HRB 21284 (AG Nürnberg)<br>
    GPG fingerprint = 93A3 365E CE47 B889 DF7F  FED1 389A 563C C272 A126<br>
<br>
</font></span></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature">Anne Gentle<br><a href="mailto:annegentle@justwriteclick.com" target="_blank">annegentle@justwriteclick.com</a></div>
</div></div>