How We Continuously Translate Tech Docs

Talked at Tokyo Rubyist Meetup in 08/16/2016.
https://trbmeetup.doorkeeper.jp/events/49120

Briefly explain about problems to translate tech documents like RailsGuides (1,500pages+) and RailsTutorial (700pages+), and sharing knowledges and experiences how we're trying to keep them up-to-date, which includes how we get a commit bit from rails/rails documentation team and how we make money from free online documents in order to continuously translate with communities.

「Railsチュートリアル (700p)」や「Railsガイド (1,500p)」といった大型の技術ドキュメントを翻訳するときの問題点や、継続的に翻訳するために試行錯誤している現状について共有します。また、Railsの公式ドキュメントチームからコミット権をもらった経緯や、無料で公開しているドキュメントでどういったビジネス展開が可能かについてもお話しします。

YassLab - Having a Good Life with OpenSource ;)
http://yasslab.jp/

Transcript

1. )PX
   8F
   $POUJOVPVTMZ
   
   5SBOTMBUF
   5FDI
   %PDVNFOUT
   :BTT-BC
2. *`N
   DPGPVOEFS
   PG
   3BJMT
   5FDI
   %PDT
   5SBOTMBUJPO
   1SPKFDU
   TJODF
   
   
3. *`N
   DPGPVOEFS
   PG
   3BJMT
   5FDI
   %PDT
   5SBOTMBUJPO
   1SPKFDU
   TJODF
   
   700P 1,500P
4. Printed Edition (¥30,000/book )
5. In Japan, you can find them by googling ’Rails’
6. Often-used by Ruby communities and help many Rails learners in Japan
7. so got an award by Matz in 2014
8. ܧଓత຋༁γεςϜ Continuous Translation System
9. A translation system that keeps translated tech documents always up-to-date
10. by reducing costs,
11. by making money,
12. UP
    CF
    "-8":4
    GSFTI
    EPDT
13. Origin Translate API Heroku Gumroad HTML PDF / EPUB Intermediate Format Scaffold Basic Translation Figure of the system ᶃ ᶅ ᶄ
14. Heroku Gumroad HTML PDF / EPUB ᶃ ᶅ ᶆ ᶄ ᶇ Translation part Origin Intermediate Format Scaffold Basic Translation Translate API
15. Heroku Gumroad HTML ຋༁نൣͷ࡞੒ (ॳճͷΈ) PDF / EPUB ᶃ ᶅ ᶆ ᶄ ᶇ Selling part Intermediate Format Translate API Origin
16. Heroku Gumroad HTML PDF / EPUB Monitoring / Feedback Origin Intermediate Format Scaffold Basic Translation ᶃ ᶅ ᶄ Translate API
17. NFSHFVQTUSFBN
    TDSJQU
18. &BTJFS
    UP
    DPNQBSF
    
    FBTJFS
    UP
    TFOE
    GFFECBDLT
19. .JTUBLFT
    BSF
    1VMM
    3FRVFTU
    $IBODF
20. 0OF
    PG
    VT
    HPU
    rails docs DPNNJU
    CJU
    
21. :PV
    DBO
    CF
    JO
    3BJMT
    0SHBOJ[BUJPO
23. :PV
    OFWFS
    LOPX
    XIFO
    UIF
    OFYU
    QFSTPO
    XIP
    TUBSUT
    KVTU
    pYJOH
    B
    NJTTQFMMJOH
    JO
    UIF
    EPDVNFOUBUJPO
    FOET
    VQ
    JNQMFNFOUJOH
    UIF
    OFYU
    HSFBU
    GFBUVSF
    
    #VU
    ZPV
    TUBOE
    B
    DIBODF
    UP
    pOE
    PVU
    JG
    ZPV
    TNJMF
    BOE
    TBZ
    UIBOL
    ZPV
    GPS
    XIBUFWFS
    TNBMM
    DPOUSJCVUJPO
    UIBU
    HFUT
    UIF
    NPUJWBUJPO
    qPXJOH
24. JP docs EN docs Code Going Step by Step
25. Heroku Gumroad HTML PDF / EPUB Build a scaffold of translation Origin Intermediate Format Scaffold Basic Translation ᶅ ᶄ ᶃ Translate API
26. Google’s one is great for start. TRANSLATOR TOOLKIT (But NOT good for continuous updates because it costs a lot and can’t automate)
27. TRANSLATION MEMORY Tech for Re-using Translation Cut into a segment Translate by segment
28. TRANSLATION MEMORY But no APIs provided by GTT Cut into a segment Translate by segment
29. Heroku Gumroad HTML PDF / EPUB Continuous Updates Translate API Intermediate Format Scaffold Basic Translation Origin ᶃ ᶅ ᶄ
30. TRANSLATION MEMORY GTT can export TMX file Cut into a segment Translate by segment
31. yasslab / konjak Handle TMX and Get a diff
32. INTEGRATE W/ API e.g. Send it to Google Translate API
33. INTEGRATE W/ API Or, you can use Gengo API, too.
34. SAMPLE OUTPUT
35. So, integrate them into one web service, named Gitlate.
36. Register original repo and target branch Preview
37. Automatically collect new commits that need to translate by hand (or by API) Preview
38. Translate only updated parts Preview
39. Send your commit as a PR Preview
40. We’re planning on releasing this
 as a web service for other OSS projects Preview
41. Scaffold Basic Translation Heroku Gumroad HTML PDF / EPUB Intermediate Format Origin Generate HTML / Test / Deploy ᶆ ᶇ Translate API
42. TEST FOR CONTENTS
43. GENERATE HTML
44. LINK TO YOUR PRODUCT
45. Scaffold Basic Translation Heroku Gumroad HTML PDF / EPUB Intermediate Format Origin Generate Ebook / Test / Deploy ᶇ ᶆ Translate API
46. MARKDOWN -> REVIEW
47. yasslab / hamidashi Test if printed outside area
48. GENERATE EBOOK
49. PUBLISH ON GUMROAD
50. from http://railsguides.jp/
51. DEMO: Ebook Edition
52. Over 1,000 pages (PDF)
53. Other experimental ways to sell contents
54. 5-DAYS BLOCK SEMINAR
55. RECORDED VER. (32H)
56. SELLING @ COMIC MARKET YOUR_COUPON_CODE
57. Heroku Gumroad HTML PDF / EPUB Origin Translate API Intermediate Format Scaffold Basic Translation ᶃ ᶅ ᶆ ᶄ ᶇ
58. Heroku Gumroad HTML PDF / EPUB Origin Translate API Intermediate Format Scaffold Basic Translation ᶃ ᶅ ᶆ ᶄ ᶇ 'FFECBDL 6QEBUF "UUSBDU 4FMM
59. ༧ࢉΛ૿΍͢ (VJEFT 5VUPSJBM
60. ܧଓత຋༁γεςϜ Continuous Translation System
61. by reducing costs,
62. by making money,
63. UP
    CF
    "-8":4
    GSFTI
    EPDT
64. /PU
    BO
    POFTIPU
    USBOTMBUJPO
    QSPKFDU
    
    CVU
    CF
    B
    DPOUJOVPVTMZ
    SVOOBCMF
    QSPKFDU Be Continuous
65. )PX
    8F
    $POUJOVPVTMZ
    
    5SBOTMBUF
    5FDI
    %PDVNFOUT
    :BTT-BC
66. provided by http://yasslab.jp/