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

Ian Y. Choi ianyrchoi at gmail.com
Fri Jan 27 13:26:01 UTC 2017


Hello Alex!

Thanks for good suggestion on archiving also translated documents, which 
is a nice idea!
Also I agree to follow EOL policy for translated documents, as Andreas 
already set "Won't fix".

I have just left a few comments currently what I think about of 
archiving translated documents on the patch link Alex shared :)


With many thanks,

/Ian

Alexandra Settle wrote on 1/27/2017 6:40 PM:
> 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