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

Tom Fifield tom at openstack.org
Wed Jan 25 10:19:06 UTC 2017


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
>
>




More information about the OpenStack-docs mailing list