[A Swift Tour] 新規文章の追加、翻訳の改善

[t-ae]

• Concurrencyがなかったので追加
• if letの同名省略の記述を追加(Swift5.7からなのでコメントアウトしています)
• その他翻訳の改善

判断に迷う箇所はコメントしていきます。

[soaringkonoha]

#315 (comment)

元のままでも意味はわかるんですが、この文で 全て を それぞれ にしたい場合、各 を使うと引っ掛かりなく読める訳になるんじゃないかなぁと。
それと、Another choice for enumeration cases is to have values associated with the case の日本語訳がちょっと違うと感じたのでレビューしてみました。

[t-ae]

@tsubasarc

元のままでも意味はわかるんですが、この文で 全て を それぞれ にしたい場合、各 を使うと引っ掛かりなく読める訳になるんじゃないかなぁと。

ここ自分の誤解が原因で元の文が変だと思って変更してしまっていました。
特定の列挙ケースの全てのインスタンス だと一つの列挙ケースにたくさんインスタンスがあるということになり、それは変じゃないかと思ったのですが、Swiftの列挙体は値型なので、別の変数に代入すればそれは異なるインスタンスになるのでした。ここは元の文に戻しておきます。

それと、Another choice for enumeration cases is to have values associated with the case の日本語訳がちょっと違うと感じたのでレビューしてみました。

レビューコメントが見えていないのですが投稿できているでしょうか？
Suggestion送っていただければ共著コミットにします。

[soaringkonoha]

@t-ae
そうだったんですね。分かりました！

レビューコメントが見えていないのですが投稿できているでしょうか？

すみません、レビューという言い方が間違ってました。
たぶん、レビュアーにアサインされていない僕は suggestion できないと思うので、さっきのはコメントとして考えを書いてみた次第です。

[t-ae]

あれ？できないですか？
私は #309 で横からsuggestion出しているのでできないことはないと思いますが…
設定上私からレビュー依頼を出すことはできないようです。

[soaringkonoha]

@t-ae ごめんなさい！
出来るにはできるのですが、アサインされてないのでロール違うかなという気持ちから出た言い方でした…。

Suggestion しますね。

[stzn]

今、お二人Collaboratorに入れてみたのですが、これでreviewerに追加できるようなりますでしょうか？

[soaringkonoha]

翻訳文を改善

[t-ae]

@stzn
Reviewersの設定ボタンは出たのですが @stzn さんしか一覧に出ませんね。
assigneesのほうも設定ボタンが出て、こちらは @tsubasarc さんも設定できるようです。

[stzn]

@t-ae さん
ありがとうございますmm方法調べてみます。

[soaringkonoha]

翻訳文を改善

[soaringkonoha]

翻訳文を改善

[stzn]

ありがとうございます!すごいわかりやすくなったように感じます🙂
いくつかコメントさせていただきましたmm

[stzn]

Raw Valueについて全部の値が等しいみたいな印象を受けるので同じ型という方が良いかなあと思いました。

関連値は初出だと思うので、それっぽい表現があった方が良いかなあと個人的に思いました。

Suggested change

	もし列挙型が Raw Value を持つ場合、これらの値は宣言の一部として決定されます。これはつまり、特定の列挙ケースの全てのインスタンスは、必ず同じ Raw Value を持つということです。もう一つの選択肢は、列挙ケースに関連づいた値を持たせることです。それらの値はインスタンス生成時に決定され、列挙ケースのインスタンスごとに異なる値を持つことができます。これらの値\(Associated Value\)は列挙ケースのインスタンスの格納プロパティのように振る舞います。例えば、サーバから日の出時刻と日の入り時刻をリクエストする場合を考えてみてください。サーバはリクエスト情報に応じたレスポンスを返すか、リクエストが間違っている場合は間違っているという内容を返します。
	もし列挙型が Raw Value を持つ場合、これらの値は宣言の一部として決定されます。これはつまり、特定の列挙ケースの全てのインスタンスは、必ず同じ型の Raw Value を持つということです。もう一つの選択肢は、列挙ケースに関連づいた値を持たせることです。それらの値はインスタンス生成時に決定され、列挙ケースのインスタンスごとに異なる値を持つことができます。これらの値\(Associated Value\)は列挙ケースのインスタンスの格納プロパティのように振る舞います。例えば、サーバから日の出時刻と日の入り時刻をリクエストする場合を考えてみてください。サーバはリクエスト情報に応じたレスポンスを返すか、リクエストが間違っている場合は間違っているという内容を返します。

[soaringkonoha]

先例

the-swift-programming-language-jp/language-guide/enumerations.md

Line 130 in e21aada

## <a id="associated-values">関連値\(Associated Values\)</a>

それ気になってるんですが、すると Raw Value の方も漢字のやつで訳が欲しくなりませんか…？

[stzn]

あーすいません。先例があったんですね。そうしましたらそのままで大丈夫です。

すると Raw Value の方も漢字のやつで訳が欲しくなりませんか…？

そうですね。Appleが公表している内容の中で適切なワードが見つかればそれを使いたいです(今は見つかっていない場合は英語表記のままというルールに沿っています)

[t-ae]

関連値は個別ドキュメントのほうで先例あったんですね… Raw Value に合わせて Associated Value にしていました。

Raw Valueについて全部の値が等しいみたいな印象を受けるので同じ型という方が良いかなあと思いました。

多分私がしていた誤解と同じ誤解をされていると思うのですが、ここで書かれている 全てのインスタンス というのはケース自体ではなくケースを代入して作られた実体を指し示しているという認識です。

enum Enum: Int { case case1, case 2}
let c1_1 = Enum.case1
let c1_2 = Enum.case1
let c2 = Enum.case2

enumは値型なのでc1_1とc1_2は別のインスタンスとなりますが、これらは必ず同じ Raw Value を持っています。
c2 も同じ型の Raw Value を持っていますが、これは別のケースのインスタンスなので違う値になります。

原文の every instance of a particular enumeration case はこの例の c1_1と c1_2 のことを指すことになるのが自然だと思いますがどうでしょうか。

[stzn]

そうですね！おっしゃる通りだと思います(すいません自分で書いておきながら...w)。suggestは気にしないでくださいmm

[stzn]

ちなみにRaw Valueですが、WWDCでは「Raw値」となっていましたが...どうなんでしょう😅

[t-ae]

Raw値…実際使われてるのは見たことないですね。
公式翻訳を重視するのもいいですが、日本語コミュニティで広く使われている呼び方があるならそれを使うというのもありかなと思います。読者がコミュニティに流れてきたときに違和感なく溶け込めるので。

ところでREADME.mdによると

なお、英語のまま表記の大文字、小文字は、原文の記載に従います。

通常の英語と同様に文の開始は大文字、その他は小文字
例: 開始 -> Computed property、その他 -> computed property

とのことですが、Raw Valueでは守られていないようですね。
この文章はCONTRIBUTION.mdのほうに記載がないので、正規のルールならそちらに追加すべきかと思います。

[stzn]

ありがとうございます!
このルール最近決まったので逆にそうなっていない所を修正したいと思ってました。なので、もし可能であれば一緒に直していただけると嬉しいですmm

issue立てました。
#317

[soaringkonoha]

遅れましたが、Collaborator への invitation ありがとうございます 🙇🏽

[t-ae]

原文ではバックティックのついていない箇所ですが、ここでは半径と名前を指すと同時に引数名を指定していると考えられます。
コードについての指定になるため、バックティックで囲うのが適切かと思い付けました。

[t-ae]

@tsubasarc
Approveして貰えればマージできる状態です。
subscriptの翻訳が残っていますが、これは後で他ファイル含め一括でやろうと思います。

[soaringkonoha]

遅くなってすみません！
Approval しました。
次回からは気をつけます… 🙇🏽