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

Alexandra Settle a.settle at outlook.com
Fri Jan 27 09:40:15 UTC 2017


Hi Ian,

I would also like to see translated documents archived ☺ 

Lana is currently working in a specification based on our conversation yesterday in our meeting. See the meeting minutes here: http://eavesdrop.openstack.org/meetings/docteam/2017/docteam.2017-01-26-21.03.log.html

I think it would be valuable to add your part to the specification which you can view here: https://review.openstack.org/#/c/426047/ 

Thoughts?

Alex

On 1/27/17, 4:53 AM, "Ian Y. Choi" <ianyrchoi at gmail.com> wrote:

    Hello,
    
    Andreas Jaeger wrote on 1/25/2017 4:33 PM:
    > 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?
    >
    > 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?
    
    I would like to kindly ask doc team members to also consider archiving 
    translated documents.
    IMHO, translated documents may have their values although the documents 
    are EOL,
    since
      - Translation contributions for documents starts after the documents 
    are released.
      - Due to a kind of nature for I18n team, some translated documents 
    might not be released
        (e.g., one translated install-guide for Liberty - but no Mitaka nor 
    Newton translated install-guide
         for the same language).
    
    Recently, one bug has been reported to openstack-i18n launchpad but I 
    have just forwarded
    to openstack-manuals: 
    https://bugs.launchpad.net/openstack-manuals/+bug/1659167 ,
    since the actual tox run is accomplished in openstack-manuals repository.
    Would not we fix this issue since Liberty is EOL? Or we need to fix 
    although it is EOL but for translated documents?
    
    Now I am a little bit inclined to fix the bug, but I am open to follow 
    Doc team's opinion :)
    
    
    With many thanks,
    
    /Ian
    >
    > Andreas
    
    
    
    _______________________________________________
    OpenStack-I18n mailing list
    OpenStack-I18n at lists.openstack.org
    http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-i18n
    



More information about the OpenStack-docs mailing list