[OpenStack-docs] [openstack-docs] Archiving documentation

Lana Brindley openstack at lanabrindley.com
Wed Jan 25 10:35:38 UTC 2017


Hi Tom,

Clearly, more conversation is required here. This mail thread has just degenerated and now we're all talking past each other. I would like to take this offline to better understand what you're asking for.

When are you available for a chat?

Lana 

On 25/01/17 20:19, Tom Fifield wrote:
> Hi Alex,
> 
> Actually, in this case I'm a Community Manager intervening in a Development Team that's failing to put user's needs first :)
> 
> The fix is 4 commands, it will help a bunch of users, it's that simple.
> 
> Where a trivial fix that would help roughly a quarter of OpenStack users is available, the documentation team should be able to take that on without going through a months-long approval process.
> 
> Regards,
> 
> Tom
> 
> On 25/01/17 18:04, Alexandra Settle wrote:
>> Tom, I would like to make the docs-team stance perfectly clear: You have suggested a solution, we have requested a specification.
>>
>> As you are a member of the core documentation team, a community team, we look forward to your patches.
>>
>> Thank you,
>>
>> Alex
>>
>> On 1/25/17, 9:29 AM, "Andreas Jaeger" <aj at suse.com> wrote:
>>
>>     On 2017-01-25 09:59, Tom Fifield  wrote:
>>     > On 25/01/17 16:55, Andreas Jaeger wrote:
>>     >> On 2017-01-25 09:34, Tom Fifield  wrote:
>>     >>> On 25/01/17 16:13, Andreas Jaeger wrote:
>>     >>>> On 2017-01-25 09:01, Tom Fifield  wrote:
>>     >>>>> On 25/01/17 15:58, Andreas Jaeger wrote:
>>     >>>>>> On 2017-01-25 08:47, Tom Fifield  wrote:
>>     >>>>>>> On 25/01/17 15:33, Andreas Jaeger wrote:
>>     >>>>>>>> On 2017-01-25 05:39, Tom Fifield  wrote:
>>     >>>>>>>>> I'd suggest that anyone on the infrastructure team would be
>>     >>>>>>>>> happy to
>>     >>>>>>>>> perform this copy (and have the access necessary to do so. Just
>>     >>>>>>>>> drop a
>>     >>>>>>>>> mail to openstack-infra at lists.openstack.org (or in
>>     >>>>>>>>> #openstack-infra) and
>>     >>>>>>>>> ask to copy the icehouse dir from 'docs-archived' to 'docs.o.o'.
>>     >>>>>>>>
>>     >>>>>>>> I can coordinate that copying - but before I do, I'd like to see a
>>     >>>>>>>> plan.
>>     >>>>>>>>
>>     >>>>>>>> Btw. copying the complete icehouse dir is wrong, I don't want to
>>     >>>>>>>> copy
>>     >>>>>>>> the Install Guide as you said as well. So, what should be copied
>>     >>>>>>>> exactly?
>>     >>>>>>>
>>     >>>>>>> Cheers, so pseudocode then:
>>     >>>>>>> scp docs-archive:/var/www/icehouse docs.o.o:/afs/docs/icehouse
>>     >>>>>>> rm docs.o.o/afs/docs/icehouse/install-guide*
>>     >>>>>>
>>     >>>>>>
>>     >>>>>> I'd like a positive list on which guides to copy over.
>>     >>>>>
>>     >>>>> Can you mail me the results of:
>>     >>>>>
>>     >>>>> find .
>>     >>>>>
>>     >>>>> in the appropriate directory on docs-archived?
>>     >>>>>
>>     >>>>> That way we can be 100% precise.
>>     >>>>
>>     >>>> find on / or on /icehouse ?
>>     >>>>
>>     >>>> On icehouse:
>>     >>>> $ ls icehouse/
>>     >>>> config-reference  index.html  install-guide  training-guides
>>     >>>>
>>     >>>> On / will be longer, if you want that, you'll get it offline later.
>>     >>>>
>>     >>>> Btw. docs-old is read-only via AFS for anybody that wants to check it.
>>     >>>
>>     >>>
>>     >>> Great! That's so simple then - since it's only the config reference,
>>     >>> it's just:
>>     >>>
>>     >>> mkdir /afs/openstack.org/docs/icehouse
>>     >>> cp -r /afs/openstack.org/docs-old/icehouse/config-reference
>>     >>> /afs/docs/openstack/icehouse/
>>     >>>
>>     >>> mkdir /afs/openstack.org/docs/juno
>>     >>> cp -r /afs/openstack.org/docs-old/juno/config-reference
>>     >>> /afs/docs/openstack/juno/
>>     >>>
>>     >>> I'll revise my estimate down to 5 minutes now :)
>>     >>
>>     >> ;)
>>     >>
>>     >> Where's the spec?
>>     >
>>     > Feel free to make one, but I'd recommend the docs team not bother with
>>     > specs for 5 minute bug-fix tasks - it's quite a bit of overhead :)
>>
>>
>>     Tom, this is not about a 5 minute fix - this is how we do it in the
>>     future...
>>
>>     And for that I want the spec,
>>     Andreas
>>     --
>>      Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
>>       SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
>>        GF: Felix Imendörffer, Jane Smithard, 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
>>
>>
> 
> 
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs

-- 
Lana Brindley
Technical Writer
Rackspace Cloud Builders Australia
http://lanabrindley.com

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 538 bytes
Desc: OpenPGP digital signature
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20170125/e0c8cd2f/attachment.pgp>


More information about the OpenStack-docs mailing list