2018-03-16、Swagger Codegenについての電子書籍が販売開始した。
REST APIのためのコード生成入門 - Swagger Codegenを利用したRESTful API開発の効率化
内容はOpanAPIやSwagger Codegenの解説、導入〜自動生成するコードをカスタマイズする方法の紹介。ご興味があるかたは1章まで無料で読めるので是非ご覧いただきたい。
原著はSwagger Codegenのトップコントリビュータである@wing328による A Beginner’s Guide to Code Generation for REST APIs で、昨年末から@taxponさんと2人で翻訳作業をしていた。
@taxponさんのブログで翻訳に至った経緯、作業プロセスやSwagger Codegenの今後にも触れられているのでご参照いただきたい。
Takuro Wada | Swagger Codegenに関する電子書籍の販売を開始しました
以下は、今回はじめて翻訳に挑戦してみた感想。
英語に全く自信が無かったが意外と出来た
今回の日本語訳の話をいただく前の2017年9月頃から、Swagger CodegenのTechnical Committee(PHP)としてissueやPRのやりとりをしていたが、英語が出来なさすぎてissueの返信に1時間以上かかることもよくあった。なので日本語訳の話をいただいた時はチャンスをもらえて嬉しい反面、とんでもなく巨大な壁が目の前に立ちはだかったように感じて “やりきれるのだろうか” と不安もかなりあった。
結果、2017年11月の作業開始から4ヶ月くらいで販売開始することができた。2018年1月の時点で翻訳自体はほぼできていて、それから先は調整(Swagger Codegenのバージョンアップに伴う内容の調整等)やレビューが主だったので、当初感じていた不安と比べたらだいぶ良いペースで進んでいた。
必要なのは日本語力だった
翻訳作業中にしばしば悩んでいたのが意訳の難しさだった。
「原著の意図は読み取れる。ただ直訳すると○○○なんだけど、もっと伝わりやすいイイ感じの日本語に意訳したいが、それが思いつかない。」というところで手が止まってしまうことが多かった。
例えば 1.3 Swagger Codegenのターゲット で、APIのエバンジェリストがSwagger Codegenを利用するメリットを挙げている箇所で原著は、
The success of an API evangelist hinges on many factors and one of them is how many developers actually use the API in production.
となっていて、これを直訳すると
APIエバンジェリストの成功は多くの要因に左右され、そのうちの1つはAPIを実際にプロダクションで使用する開発者の数です。
になると思うが、日本語版ではこれを下記にしている。
APIをプロダクトで利用する開発者の数は、そのAPIの成功を示す重要なファクターのひとつです。
(ここだけ抜き出して例示しても、良くなっているかどうかわかりにくいかもしれない…)
おわりに
今でも英語のやりとりには四苦八苦してはいるが、翻訳を経験したことで心理的ハードルはだいぶ下がったように感じている。また月並みだが、英語のドキュメントを眺めて内容を把握するのと、それを母国語で相手(読者のかた)に伝えるのは違う難しさがあって面白かった。
原著者であり、Swagger Codegenのトップコントリビュータである@wing328はコミュニティを本当に大切にしていて、彼のコミュニティに敬意を払う姿勢が本書の端々にもあらわれている。電子書籍の販売についても、販売によって得られるものをコアメンバーやテクニカルコミッティに還元したいという想いもあるようだ。
自分がSwagger Codegenに関わるようになった経緯は Swagger Codegen Core Teamにジョインした に書いたが、ちょっとしたきっかけでコントリビュートするようになり、それが今回日本語訳の話につながり貴重な経験をさせていただいた。これからもコミュニティの一員としてSwagger Codegenに貢献していきたい。
また、”Swagger Codegenへのコントリビュートに興味があるけど、何からやったらいいのかわからない” というかたは是非 help wantedラベルが付いているissue を眺めてみることをおすすめします。または僕にご連絡ください :)