Open Stack

On Mon, Mar 30, 2015 at 2:27 AM, Andreas Jaeger <aj at suse.com> wrote:

> On 03/30/2015 09:14 AM, Lana Brindley wrote:
>
>> On 30/03/15 15:26, Andreas Jaeger wrote:
>>
>>> On 03/30/2015 03:11 AM, Lana Brindley wrote:
>>>
>>>>
>>>> * Information Architecture: do we need a User Guide + Admin Guide? Can
>>>> we combine or split this in a better way? What components should we be
>>>> documenting (core only/core+)?
>>>>
>>>> With the Easter break coming up, we decided to all spend some time on
>>>> answering this question over the next couple of weeks. We have a lot of
>>>> Information Architecture expertise in the group, and individuals have
>>>> been asked to email the mailing list with [User Guides] in the subject
>>>> line with their suggestions.
>>>>
>>>
>>> Sorry, this does not help me at all.
>>>
>>> If we want to have split guides, we need to figure out how to do this
>>> properly. If we want to have this ready on the 7th of August, I don't
>>> want to work on this and have it reverted after a couple of weeks,
>>>
>>>
>> To be honest, I think trying to solve this by 7 April is unrealistic.
>> Restructuring a document, and doing it properly, is not something to
>> take lightly, and I'd rather hold off and do a great job then rush into
>> it and make mistakes.
>>
>> Is there something that would be helpful to you in the short term that
>> we can help with? What, exactly, are you trying to achieve by 7 April?
>>
>
> See the log from our last meeting at 14:06:15
> http://eavesdrop.openstack.org/meetings/docteam/2015/
> docteam.2015-03-25-14.00.log.html
>
> Anne mentioned having the RST guides ready by the 9th (not the 7th, sorry).
>
> So, let's discuss how to move forward here in the best way.
>
> My question basically is:
>
> Do we want to have separate guides (like today) published from RST by the
> 9th of April (and restructure later)? If not, what's the plan?
>
>
I think it's fine to restructure later. Then we have complete parity for
the Kilo release date. The April 9 deadline is the same as the first
release candidate for Kilo.

Lana, have a blueprint for any restructuring for the next release, with
deadlines set in the blueprint itself. That should work for us all to keep
moving.

Thanks,
Anne




> 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
>
>
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>



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