Open Stack

Hi all,

I've started this spreadsheet with some of the data and I'll put it on the
agenda to discuss at tomorrow's doc team meeting.

So far it shows number of readers and number of contributors, and some of
the complexity values. I'll add number of translations next.

https://docs.google.com/spreadsheets/d/10HD6iW1CtfB1qT2wVODYiHdC0ysr4xw392VCqHB-aaY/edit?usp=sharing

I haven't studied it enough to draw any conclusions, so bring yours to
tomorrow's meeting.
Thanks,
Anne

On Tue, Mar 31, 2015 at 10:54 PM, Anne Gentle <annegentle at justwriteclick.com
> wrote:

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



-- 
Anne Gentle
annegentle at justwriteclick.com
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20150407/56c6c829/attachment.html>