[Openstack-docs] What's Up Doc? May 24, 2013

Anne Gentle anne at openstack.org
Tue Jun 4 19:05:03 UTC 2013


Agreed on what Lorin said -- thanks Andreas for pointing it out to us.

I do agree with the overlap. One idea for collaboration - bring it into the
openstack-manuals repo and use conditional output for the screenshots for
the SUSE Cloud dashboard, output two different guides, like we do for
install guides. Does that make sense? It might get translated quicker by
being in the OpenStack ecosystem. It's definitely a document we could then
expand upon with tutorials and use cases.

How would you like to share the XML source? Do you think conditional markup
is worth the effort to single-source the guide for different dashboard
screenshots?

I do have to compliment the writer or writers on the organization and
clarity of these guides. Well done.

Anne


On Fri, May 24, 2013 at 10:23 PM, Lorin Hochstein
<lorin at nimbisservices.com>wrote:

> Hi Andreas:
>
> It's great to see this content. In particular, I'm really happy to see a
> SUSE-specific deployment guide. The doc team is trying to transition away
> from writing deployment documentation, because it's so
> distribution-specific.
>
> Take care,
>
> Lorin
>
>
> On Fri, May 24, 2013 at 3:03 PM, Andreas Jaeger <aj at suse.com> wrote:
>
>> Hi Anne, Diane and the rest of the docu team,
>>
>> I'm part of SUSE's cloud team and talked with my colleague Tanja Roth
>> from the SUSE documentation team this week and wanted to followup with all
>> of you after my vacation (which starts now and goes for two weeks). But
>> your nice summary contains one point where I think I should answer directly:
>>
>>
>> On 05/24/2013 05:47 PM, Anne Gentle wrote:
>>
>>> What's new with you? Here's what's new in OpenStack doc-land.
>>>
>>> [...]
>>>
>>
>>  2. High priority doc work:
>>> Diane's working on a user guide, as part of the refactoring. Please
>>> review the outline at
>>> https://wiki.openstack.org/**wiki/Blueprint-os-user-docs#**Summary<https://wiki.openstack.org/wiki/Blueprint-os-user-docs#Summary>.
>>> I've
>>> given her (way too many) ideas for use cases, but more are welcomed as
>>> we shape this new deliverable.
>>>
>>
>> We at SUSE have released our SUSE Cloud - which is a distribution based
>> on OpenStack - and have three manuals available, you can see all of them at:
>> https://www.suse.com/**documentation/suse_cloud10/<https://www.suse.com/documentation/suse_cloud10/>
>>
>> There's also a user guide - and looking at the blueprint and at the table
>> of contents of SUSE's guide, I see a lot of high level overlap. Thus, I
>> wanted to point this out to everybody so that you can discuss whether and
>> in which way collaboration is possible.
>>
>> The SUSE Documentation is under the Apache license and we can share our
>> XML sources for them,
>>
>> Andreas
>> --
>>  Andreas Jaeger aj@{suse.com,opensuse.org} Twitter/Identica: jaegerandi
>>   SUSE LINUX Products GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>>    GF: Jeff Hawn,Jennifer Guild,Felix Imendörffer,HRB16746 (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 <Openstack-docs at lists.openstack.org>
>> http://lists.openstack.org/**cgi-bin/mailman/listinfo/**openstack-docs<http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs>
>>
>
>
>
> --
> Lorin Hochstein
> Lead Architect - Cloud Services
> Nimbis Services, Inc.
> www.nimbisservices.com
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20130604/b927823d/attachment.html>


More information about the Openstack-docs mailing list