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

Alexandra Settle a.settle at outlook.com
Wed Jan 25 10:04:36 UTC 2017


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