経緯 https://discord.com/channels/291054398077927425/428386158523842570/981107422766727208

わいわい！

3

わいわい

1

作っていただいたのにすぐ動けなくてごめんですが、ちょっとわたわたしているので土日あたりにNext Actionしますね〜

ありがとうございます

‍♂️ ひとまずの共有ですが、swift.orgへのリンクの件はこちらで話しています。 https://forums.swift.org/t/the-swift-programming-language-japanese-translation/57715

The Swift Programming Language Japanese Translation

Hello, everyone. We decided to maintain this TSPL Japanese translation in Japanese Swift developer community. Here is the deployed site Here is the Github repo We would be glad if it’s linked to Translations. What should we do for it? Thanks!

1

@shiz Chinese, Korean, Spanish はアルファベット順に並んでいるのかもですね。 https://github.com/apple/swift-org-website/pull/71/files

Add Japanese translation in Translations by stzn · Pull Request #71...

Add TSPL Japanese translation Related forum thread: https://forums.swift.org/t/the-swift-programming-language-japanese-translation/57715 Motivation: We decided to maintain this TSPL Japanese transl...

1

2:20 AM

コミット履歴を遡ってみましたが、その三つの言語はまとめて初回コミットされていて、アルファベット順を意図しているのかはわかりませんでした。今後言語が増えることを考えるとアルファベット順の方が探しやすそうには思います。

1

koher

@shiz Chinese, Korean, Spanish はアルファベット順に並んでいるのかもですね。 https://github.com/apple/swift-org-website/pull/71/files

ありがとうございますmm一旦コメントで聞いてみてます。 (edited)

1

@koher やはりアルファベット順だったので修正してApproveしてもらいました。もうちょっと様子みて、今日中にマージ予定のようです

ありがとうございました

‍♂️

1

Wow, that’s very very subarashii!

ってコメントあってほっこりした

7

マージされました

https://www.swift.org/documentation/#translations (edited)

Swift.org

Swift is a general-purpose programming language built using a modern approach to safety, performance, and software design patterns.

16

はやい！

公開するまでも何か作戦がいるだろと思っていましたが動いたら一瞬でしたね〜

1:16 PM

次はメンテを盛り上げてくのをやっていきましょう

1:17 PM

Swift愛好会Slackで宣伝しといた

1

ひとまず、今後やっていくことや進め方、その他気をつけたいことなどをまとめました。(一部CONTRIBUTIONの内容と被ってますが) 不明な点などはお気軽にこちらのチャンネルに書いていただけますと

‍♂️ - ドキュメントの更新のタイミング

公式ドキュメントの更新のタイミングでこちらのドキュメントの更新作業も開始します。Appleから更新のお知らせはないと思われます。去年の経験から考えるとWWDC22後にSwift5.7 Beta版に更新されるはずです。

- 変更箇所の特定

まずはDocument Revision Historyを見て、変更のあった項目と内容を確認します。https://docs.swift.org/swift-book/RevisionHistory/RevisionHistory.html

記載のない箇所も変更されていることが多々あるので、変更箇所を探します。Appleの人にうまい見つけ方がないかを聞きましたが、最新のePubをダウンロードして過去のePubとの差分を見てみる、という回答でした。以前calibreというツールを使って試してみましたが、画像の差し替えなどがあるとバイナリの差分が出てしまいあまり活用できず、結局は地道に探しました。何かうまい方法をご存知の方がいれば教えていただいきたいですmm

Document Revision Historyにしたがってissueを立てたいと思います。各ページ内の見出し単位に分かれています。 できそうなissueのAssigneesのリストに自身の名前を追加します。最初にこれを行うことで作業の重複が起きないようにしたいです。

こちらで必要なissueは用意する予定ですが、上記に記載のように、地道に探す必要もあるため、抜け漏れが発生することが多いにあり得ます。なので、もしissueにない変更に気づいた場合は新しくissueを立ててください。issueを立てたからといって自身で必ず修正する、ということはありません。

一度issueを受け持ったとしても、きつそうでしたら外れていただいて大丈夫です。途中まで行っていた場合は、きりの良いところまで行っていただき、issueにどこまでやったのかを記載して、PRを出してください。issueは開いたままにしておき、続きを他の方が行っていきます。

- 修正方法

元のリポジトリをforkして作業してください。

修正後は元のリポジトリのmasterブランチに対してPRを出してください。

PRへのコメントはどなたでも可能です。みんなでより良いものにしていけたら良いなと思っています。

マージ権限については特定の人に限らせていただきます。基本的にreviewは1日以内に開始する予定ですが、もし反応がない場合はdiscordやPRのコメントでreviewerにメンションをお願いします。

- その他

当たり前の話ですが、他の方への誹謗中傷はしないでください。もし気になることがありましたら、discordやtwitterのDMで僕宛までメッセージをください

サイト自身に対するリクエストなどに関してもissueを立ててください。僕自身、webサイトに関する知識も経験も全然足りていませんので、改善方法の提案やPRをいただけるととても嬉しいです。

無理はしないでください。ベストエフォートでみんなで分担していけたら良いなあと思ってます。

(edited)

4

ちなみにSwift5.7は今ぱっと思いつくだけでも変更がすごいたくさんあるなあと感じています

やるぞ

2

>去年の経験から考えるとWWDC22後にSwift5.7 Beta版に更新されるはずです。と思ったら早速Swift5.7に更新されていたので、まずissue作っていきます https://docs.swift.org/swift-book/RevisionHistory/RevisionHistory.html (edited)

1

issue作成しました。v5.7のラベル付けています。もしやりたいものがあればAssigneesにお名前追加してください! https://github.com/stzn/the-swift-programming-language-jp/issues (edited)

1

2つのissueに対するPR作成してみました。もしお時間あれば見てみてください

(※PRを出してもこちらに投稿していただかなくて大丈夫です。) https://github.com/stzn/the-swift-programming-language-jp/pull/254 https://github.com/stzn/the-swift-programming-language-jp/pull/256 (edited)

1

WWDCも終わったので、修正した箇所は順次マージしていきます。もしご指摘などがあればこちらのチャンネルやgithubのissueでお知らせください

(edited)

README.mdにご協力いただいた皆様の一覧をGithub APIを使って出そうと思っているのですが、こういうのって、個々に掲載OKかどうかの確認した方が良いでしょうか？？使おうとしているGithub action https://github.com/marketplace/actions/contribute-list PR https://github.com/stzn/the-swift-programming-language-jp/pull/259/files (edited)

活動自体はGitHub上ですでにPublicになっているので「掲載させていただきました！（困ることがあったら教えてください）」というスタンスでいい気がします〜

1

1

ちょっと落ち着いたのでissue一通り拝見しました！少しずつやっていき

1

shiz

README.mdにご協力いただいた皆様の一覧をGithub APIを使って出そうと思っているのですが、こういうのって、個々に掲載OKかどうかの確認した方が良いでしょうか？？使おうとしているGithub action https://github.com/marketplace/actions/contribute-list PR https://github.com/stzn/the-swift-programming-language-jp/pull/259/files (edited)

出してみましたー -> Webページでの表示がおかしいですねw修正します。 https://github.com/stzn/the-swift-programming-language-jp#contributors (edited)

1

自動生成されるhtmlのtableタグをうまく読み取れていなかったようです。なので出力方法変えました

https://github.com/stzn/the-swift-programming-language-jp#貢献者 https://www.swiftlangjp.com/#貢献者 (edited)

1

↑前の形式に戻してみました。何か変なところありましたら教えていただけますと

(edited)

こういった形で改善PRをいただけると大変うれしいので、もし何か気がついたことがあればほんのちょっとで全然大丈夫ですのでお気軽にお願いします

https://github.com/stzn/the-swift-programming-language-jp/pull/291 (edited)

[Lexical Structure] 読みやすさの向上 by tsubasakat · Pull Request #291 · st...

Closes #271 読みやすさと理解しやすさの向上を目指した変更です。なるべく前提から読めるように、いつくか文の構成を変えています。文が同じ語尾で繰り返し終わると単調になりやすいので、これについてもいくつか変更を試みました。また、文のリズムを乱さないよう読点の数も減らしています。