[OpenStack-docs] [openstack-docs] Archiving documentation
Andreas Jaeger
aj at suse.com
Wed Jan 25 07:58:58 UTC 2017
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.
>
>> Moving to docs-archived just a single directory right now is the wrong
>> way: It still breaks existing URLs, why not use /icehouse? Then, which
>> other directories to copy over? How do you want to make these archived
>> versions available - there's no /icehouse or /docs-archived index page.
>> What are we doing about translations of the documents?
>
>
> Yup, copying icehouse to /icehouse is indeed the idea. If versions
> post-icehouse haven't been copied, suggest doing those too (everyone
> loves a for loop!). No need to touch the index pages at this time - just
> putting the files back will fix the 404s for those who have got those
> bookmarks and links they're following. For translations, I believe they
> live under the release root directory in a lang code sub directory, so
> they will come across, though there may be the need to add rm
> docs.o.o/icehouse/*/install-guide* to get those too, as above.
Could you please write up a spec to consolidate on what you propose?
There are bits and pieces flying around in this thread and once we
agreed on the big picture, I'll take care of that copy,
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
More information about the OpenStack-docs
mailing list