zembutsu / docs.docker.jp Goto Github PK
View Code? Open in Web Editor NEWDockerドキュメント日本語化プロジェクト ,Docker Documentation Translate Project for ja-jp
Home Page: http://docs.docker.jp
License: Apache License 2.0
Dockerドキュメント日本語化プロジェクト ,Docker Documentation Translate Project for ja-jp
Home Page: http://docs.docker.jp
License: Apache License 2.0
以下の commit を拝見しました: 6a8bd29#diff-f98146989f8c44bf5222cf647d50ffa2
ここにおいていくつか、翻訳指針に関わる私の見解を述べさせて頂きます。非常に事細かな部分ではありますが、翻訳全体の統制を図る意味では欠かせない内容と考えます。この件は、ゆくゆく当 github 内の Wiki にでも取りまとめるべきではないかと考えますが、さしあたり以下の具体例を提示することで、問題提起とさせていただきます。
語句の訳出に関して(私見): (上記 commit 内)
上記私見に関しては、ほぼ接続詞など平易なものを対象とし、それらをすべてひらがな表記とすべきという考えを示しているものです。賛否は当然あろうかと思います。ただしマニュアルという性格上からは、平易な文面を目指すことが不可欠なことと捉えます。「である調」でなく「ですます調」をもとから採用されている点は、ごく自然で至極適当と思います。同様の観点で、ひらがな表記を積極的に推し進めるべきとの考えを持っています。嘘のような実は真剣な話として、ひらがなにすると文書全体が黒ずむことなく白んで見えるので、それだけでも読みやすくとっつきやすくなるという見解(?)も、どこかで見聞きしたことがあります。その考えに感化されている意識です。
以上、よろしくお願いいたします。
reference中にコマンドのヘルプが英文そのままで入っている。
コマンドの解説も兼ねているので、翻訳したほうがよいのでは。
CONTRIBUTING.mdがないため、
gitを常用していないが、dockerを利用しているような人がドキュメントを読んでいて課題修正をしたい時にできない。
上記の問題を改善できるようなCONTRIBUTING.mdをルート直下に配置する。
◾️サイトのページURL
http://docs.docker.jp/engine/docker-overview.html#docker-architecture
該当箇所
gh Docker はクライアント・サーバ型のアーキテクチャです。
本家 Docker 版のドキュメント( https://docs.docker.com/ ) との差分が開いてきたため、各ドキュメントを最新版にアップデートする。
Docker CE v18.09のリリースにあわせたタイミングで、各種ドキュメントを見直す。
基本的に Docker Engine、Compose、リファレンスの対応を目指す。
カタカナ用語の語末に長音符号をつけるかどうかについては、各所でいろいろ議論されるところかと思います。私個人はこの件に関して、経緯(内閣告示やJIS慣例、報道分野の姿勢、昨今の「つける」派への動きなど)や評価に関しての知識があり持論があり、結論としては例外なく「つけるべき」という意見を持っています。
現行訳は「つけない」派であり、そこは今後も変えるおつもりはないでしょうか。時流からすると「つけるべき」と思っております。各位のご意見を頂けたら幸いです。
素敵なドキュメントをありがとうございます。素晴らしい翻訳に驚きました。私も時間ができたらお手伝いさせていただきたいなと思います。その前に、読んでいてひとつ感じたことを。
記事のどこかにオリジナル記事へのURLがあると、読む人も翻訳者も便利かなと思います。(私が見つけれていないだけ?)
ToDoのページも、オリジナルページに飛べるとコマンドだけでも見れたりするので英語が読めない人も多少は助かるかと思います。
いかがでしょうか。
Qiita上ものが古くなっているので、今回作成した環境との整合性をどうするか?
方針案:
https://docs.docker.com/registry/notifications/
このページの図が未対応。
CONTRIBUTING.mdがないため、
gitを常用していないが、dockerを利用しているような人がドキュメントを読んでいて課題修正をしたい時にできない。
上記の問題を改善できるようなCONTRIBUTING.mdをルート直下に配置する。
以下のドキュメントにちょっとしたtypoがあります。
http://docs.docker.jp/docker-hub/builds.html
ドキュメントの修正を行いやすくするため、GitHubへの導線を追加する。Sphinx側のテーマ編集作業。
http://docs.docker.jp/engine/understanding-docker.html#id22 に「Docker は LXC を使う伝統的な Linux コンテナもサポートしています。」とありますが、 https://github.com/docker/docker/releases/tag/v1.10.0 の Deprecations で「Remove LXC support.」と書いてあり、 https://docs.docker.com/engine/understanding-docker/ でも LXC の記述は消えているようです。
英語では dockerize
や dockerization
という表現が出てきます。これをどう訳するか迷ってます。
これを純粋に「Docker化」と訳すべきか、あるいは「Docker対応」のように日本語として自然な感じにするべきでしょうか。ちょっと迷っているので、一旦 issue にあげておきます。
「Copyright 2015-2017, Docker Docs Translation Ja-Jp Project.」
とありますが、Copyright Docker Inc. の間違いではありませんでしょうか?
Docker CE のインストール 以下の、CentOS 用 Docker CE の入手ページ以降を拝見しながらセットアップを行っていて気づいたのですが、日本語訳ページでは、原文の下記の部分が欠落しているようです。
1.Use the following command to set up the stable repository. You always need the stable repository, even if you want to install builds from the edge or test repositories as well.
$ sudo yum-config-manager \ --add-repo \ https://download.docker.com/linux/centos/docker-ce.repo>
素晴らしい成果物を公開して下さっている事を感謝いたします。
Usage等がそのままだが、分量が多いため後まわし。
右下の worker01
は、正しくは dbstore
だと思います
https://github.com/zembutsu/docs.docker.jp/blob/master/swarm/images/final-result.png
PRできないのでIssueあげておきます。
https://github.com/zembutsu/docs.docker.jp/blob/master/conf.py#L307
リポジトリになく @zembutsu さんのローカルにあるようなのでリポジトリに入れていただきたい。
7/28公開の Docker Engine 1.12 GA リリースにあわせて、ドキュメントの更新。
Docker ドキュメント日本語版 PDF ダウンロードが「HTTP 403 アクセス不可」エラーとなりダウンロードできないのですが、アクセス制限等あるのでしょうか。
この記事の
$ docker run -d -P --name web -v /opt/webapp:ro training/webapp python app.py
は実際には
$ docker run -d -P --name web --read-only -v /opt/webapp training/webapp python app.py
ではないかと思われます。
run mount volume 参照
matsuand と申します。
Docker に興味を抱き、また英文翻訳に相当の興味を頂いていることから、是非 Docker 日本語化プロジェクトに参加して作業を進めたく思っています。
どのように参加させて頂いたら良いのか、皆目見当がついていません。この点を issue として挙げさせて頂きます。初めはざっくりし過ぎる課題かもしれませんが、適宜、細分化できれば、それに応じて当 issue を close、新たな issue を open していくことになるかと思います。
さしあたり当 issue では、次の観点を挙げさせて頂きます。
各位のご意見を賜りたく、列記してみました。ご意見ご指示があればよろしくお願いします。「言い出したお前がやれ」とご指示を頂けたら、積極的に動きます。ただし github の操作、運用方法に不慣れであり、また当プロジェクトの存在を知ったのがつい最近であるため、これまでの各位のご尽力や作業経緯などを全く承知していません。よろしくお願い致します。
特定の用語の英日対応表
Running on OS X
https://docs.docker.com/registry/osx-setup-guide/
Build instructions
https://docs.docker.com/registry/building/
着手しましたが、途中で一旦保留。思ったより項目が多くて時間取られるので。
https://docs.docker.com/registry/configuration/
あと、積み残しタスクがどこで発生したか自分でも分からなくなるので、今後は issue に残していきます。
サイドバーのトップと下の方に用語集が重複して存在します。
用語集を開いている時にサイドバー上では2つともがサブメニューを展開しており、視覚的に邪魔です。
確認後、逐次翻訳する。
出来るだけ制限をかけず、参照・再利用しやすいライセンスにする。予定。
カタカナ用語が名詞語句として複数連なったとき(例えばコンテナ・インスタンス)、本訳は全般に中黒(・)を置いています。これも各所で是非があるように思います。さらに中黒を置く方針のように見受けながら「コンテナインスタンス」のように、中黒を書いていない訳例も見かけました。
他所では空白を入れるとする取り決めもあるようですが、私は中黒も空白も共に不要と思っています。いかがですか?
タイポ見つけた。
docker-compose up
->docker-compose ps
docker-compose rum
->docker-compose run
https://twitter.com/Sapphirus/status/701439373091299330
repositoryの訳語は、国内で広く一般的に使われている「リポジトリ」に統一の予定です。
https://twitter.com/hnakamur2/status/737356547349581824
「build times」の誤訳
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.