Jump to: navigation, search

Difference between revisions of "I18nTeam/docs-translation"

(Alternative suggestion of categorization)
m
 
(23 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
[[Category:I18n]]
 +
 +
This page is not maintained now (Aug 2017).
 +
The documentation structure is being restructured drastically.
 +
 
=== Document categorize ===
 
=== Document categorize ===
 
Translation team use this page to track the status of documents and decide the priorities of translation.
 
Translation team use this page to track the status of documents and decide the priorities of translation.
  
{| class="wikitable"
+
{| class="wikitable sortable centre" style="text-align: center;"
|-
+
|-  
! Changes !! End users !! Admins !! Developers
+
! scope="col" | Resources
|-
 
| Frequently changed ||  ||  || 
 
|-
 
| Changed a few ||  ||  || 
 
|-
 
| Stable ||  ||  || API Quick Start (1,077words)
 
|}
 
 
 
=== Alternative suggestion of categorization ===
 
 
 
Here is a small example :
 
 
 
{| class="wikitable sortable centre" cellpadding="20" cellspacing="0"
 
|-
 
! scope="col" | Projects
 
! scope="col" | Ressources
 
! scope="col" | Type
 
 
! scope="col" | Target  
 
! scope="col" | Target  
! scope="col" | Frequently changed
+
! scope="col" | Update Frequency
! scope="col" | Size
 
 
! scope="col" | Priority
 
! scope="col" | Priority
 
! scope="col" | Comments
 
! scope="col" | Comments
 
|-
 
|-
| Horizon || Juno - Horizon Translations || UI || End users ||  ||  || 1 - High ||  
+
| admin-guide-cloud || Admin || Content stable || 2 - Medium || Under reorganization for Mitaka, from role-based to task-based
|-
 
| OpenStack Manuals || api-quick-start || Documentation || Developers || Stable || 1077 || 1 - High ||
 
|-
 
| OpenStack Manuals ||  z-old-basic-install  || Documentation || n/a || Archived || 1264 || 5 -  To be deleted ||
 
|-
 
| OpenStack Manuals ||  api-guide || Documentation || Developers || Stable || 103 || 1 - High || Contains WADLS we can't translate at the moment
 
|-
 
| OpenStack Manuals ||  api-ref-guides || Documentation || Developers || Stable || 211 || 1 - High || Contains WADLS we can't translate at the moment
 
 
|-
 
|-
| OpenStack Manuals || api-ref || Documentation || Developers || Stable || 4151  || 1 - High ||  
+
| api-guide || Developers || Stable || 1 - High ||  
 
|-
 
|-
| OpenStack Manuals || user-guide || Documentation || End users || Unstable || 12339 || 3 - Low ||  
+
| api-ref-guides || Developers || Stable || 3 - Low || Contains WADLS we can't translate at the moment
 
|-
 
|-
| OpenStack Manuals || z-old-openstack-install  || Documentation || Admin || Archived || 17101 || 5 - To be deleted ||  
+
| arch-design || Admin || Content stable || 3 - Low || Under reorganization for Mitaka
 
|-
 
|-
| OpenStack Manuals || z-old-openstack-compute-admin || Documentation || Admin || Archived || 38990 || 5 -  To be deleted ||
+
| api-ref || Developers || Unstable || 3 - Low || API is going to be changed. So this doc will be changed in the future.
 
|-
 
|-
| OpenStack Manuals || user-guide-admin || Documentation || Admin || Unstable || 7480 || 3 - Low ||  
+
| user-guide || End users || Content stable || 1 - High ||  
 
|-
 
|-
| OpenStack Manuals || Common || Documentation || Common || Unstable || 73557 || 2 - Medium || Config tables will be moved out of common into config-reference
+
| user-guide-admin || Admin || Content stable || 3 - Low || Under reorganization for Mitaka, will be merged into admin-guide-cloud and removed
 
|-
 
|-
| OpenStack Manuals || install-guide || Documentation || Admin || Stablises ~1 week after release || 20190 || 2 - Medium || Stablises ~1 week after release, then about 1 month after that becomes unstable again
+
| common || Common || Stable || 2 - Medium || Glossary (RST) and contents are used by other books
 
|-
 
|-
| OpenStack Manuals || z-old-cli-guide  || Documentation || Admin || Archived || 2861 || 5 - To be deleted ||  
+
| glossary || Common || Stable || 3 - Low || For DocBook, glossary for RST is inside common
 
|-
 
|-
| OpenStack Manuals || training-guides || Documentation || End users || Do not translate || 62743 || 4 - To be rewrite || Needs a complete rewrite in the future
+
| install-guide || Admin || Stable || 1 - High || Work In Progress
 
|-
 
|-
| OpenStack Manuals || cli-reference || Documentation || Developers || Unstable || 16796 || 2 - Medium ||  
+
| ha-guide || Admin || Unstable || 3 - Low ||
 
|-
 
|-
| OpenStack Manuals || z-old-openstack-ha || Documentation || Admin || Archived || 4021 || 5 -  To be deleted ||
+
| openstack-ops || End users || Content stable || 2 - Medium || Plan to be reorganized for Newton
 
|-
 
|-
| OpenStack Manuals || high-availability-guide || Documentation || Admin || Do not translate || 6919 || 4 - To be rewrite || Needs a complete rewrite in the future
+
| config-reference || Admin || Unstable || 3 - Low ||
 
|-
 
|-
| OpenStack Manuals || user-guide || Documentation || End users || Unstable || 12 339 || 3 - Low ||  
+
| image-guide || End users || Unstable || 2 - Medium ||
 
|-
 
|-
| OpenStack Manuals || user-guide || Documentation || End users || Unstable || 12 339 || 3 - Low ||  
+
| security-guide || Admin || Stable || 2 - Medium ||
 
|-
 
|-
| OpenStack Manuals || user-guide || Documentation || End users || Unstable || 12 339 || 3 - Low ||  
+
| upgrade-guide || Admin || ??? || ??? || Under discussion (at now, inside OpsGuide)
 
|-
 
|-
| OpenStack Manuals || user-guide || Documentation || End users || Unstable || 12 339 || 3 - Low ||  
+
| networking-guide || Admin || Stable || 2 - Medium ||
 
|-
 
|-
| OpenStack Manuals || user-guide || Documentation || End users || Unstable || 12 339 || 3 - Low ||
 
 
|}
 
|}
 
===Discussion===
 
* Attempt at categorising documents: https://etherpad.openstack.org/p/i18n-manuals-classification
 

Latest revision as of 14:35, 4 August 2017


This page is not maintained now (Aug 2017).
The documentation structure is being restructured drastically.

Document categorize

Translation team use this page to track the status of documents and decide the priorities of translation.

Resources Target Update Frequency Priority Comments
admin-guide-cloud Admin Content stable 2 - Medium Under reorganization for Mitaka, from role-based to task-based
api-guide Developers Stable 1 - High
api-ref-guides Developers Stable 3 - Low Contains WADLS we can't translate at the moment
arch-design Admin Content stable 3 - Low Under reorganization for Mitaka
api-ref Developers Unstable 3 - Low API is going to be changed. So this doc will be changed in the future.
user-guide End users Content stable 1 - High
user-guide-admin Admin Content stable 3 - Low Under reorganization for Mitaka, will be merged into admin-guide-cloud and removed
common Common Stable 2 - Medium Glossary (RST) and contents are used by other books
glossary Common Stable 3 - Low For DocBook, glossary for RST is inside common
install-guide Admin Stable 1 - High Work In Progress
ha-guide Admin Unstable 3 - Low
openstack-ops End users Content stable 2 - Medium Plan to be reorganized for Newton
config-reference Admin Unstable 3 - Low
image-guide End users Unstable 2 - Medium
security-guide Admin Stable 2 - Medium
upgrade-guide Admin  ???  ??? Under discussion (at now, inside OpsGuide)
networking-guide Admin Stable 2 - Medium