Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

New Translation Progress Checklist #452

Open
no-yan opened this issue Dec 1, 2021 · 54 comments
Open

New Translation Progress Checklist #452

no-yan opened this issue Dec 1, 2021 · 54 comments

Comments

@no-yan
Copy link

no-yan commented Dec 1, 2021 •
edited by smikitky
Loading

ページを翻訳したい方へ：

重複作業を防ぐため、まずはここでどのページを翻訳するか宣言してください。宣言なしで翻訳が行われて他の人の作業と被ってしまった場合、原則として（PRを先に作った人ではなく）ここで最初に宣言があった人を優先します。ただし宣言が行われて 1 週間以上 PR が作成されないなどの場合は適宜対応します。

スタイルガイドおよび単語リストをチェックして、翻訳が一貫した方法で書かれていることを確認してください。

New Articles

Progress : (🏃 進行中の作業; 👀 レビュー中）

Main Content

To do before releasing as an "official" translation. Please translate these pages first.

Note that each section has an index page, which needs to be translated too.

Learn React

API Reference

Navigation and UI

We suggest to leave most of the UI translation until the end. We plan to do some invasive changes to the website folder layout and components, so postponing this until your translation is almost complete would make it easier to merge the changes from our side later. It might make sense to translate the homepage above the fold early, but leave the rest for later. As individual pages get translated, you can change the page titles in the corresponding sidebar files. Finally, when you're translating the navigation, make sure to test both desktop and mobile layouts.

When You're Ready...

After everything above is translated, add your language to deployedLanguages in Seo.tsx of the original reactjs/react.dev repository.

Secondary Content

These API pages should ideally be translated too, but they're less urgent and can be done after the others:

Optional Content

These aren't the main translation targets, but if you'd like to do them, feel free to expand the list to include their subpages:
@no-yan
Copy link
Author

no-yan commented Dec 1, 2021

進捗管理用のissueが閉じられていたので、新規issueを開きました。気軽に閉じてください。

この形式でやる場合の懸念点として、Statusの更新が面倒になる可能性があります。どれが更新かわかるようにupstream側で配慮があればよいですが、そうでない場合は頑張って40近いリストから差分を見つける必要がありそうです。

@smikitky
Copy link
Member

smikitky commented Dec 1, 2021

既にちょっと手を付けてはいるのですが、まだブランチプレビューがセットアップされておらず、textlint も動いておらず、本家の方でも認識していなかった細々とした問題が見つかったり…という状況ですので、ひとまずワークフローを確立するのが先決という状況です。

これで大丈夫そうというところで以前のように翻訳者を募集することになると思いますので、しばらくお待ちください。

@smikitky smikitky added the beta label Dec 1, 2021
@smikitky smikitky mentioned this issue Dec 1, 2021
Closed
7 tasks
@smikitky smikitky changed the title [Beta] Translating New React Docs [Beta] Translation progress checklist Dec 1, 2021
@smikitky smikitky pinned this issue Dec 22, 2021
@pasteisdenata
Copy link
Contributor

こんにちは。技術翻訳をしている者です。オープンソースのプロジェクトに関わった経験はないのですが、是非お手伝いしたく、よろしくお願いします。既にフォークは作成済みです。どのセクションの翻訳から開始すればよいですか。

@no-yan
Copy link
Author

no-yan commented Mar 28, 2022

（メンテナの方々からお返事がないようなので）
ありがとうございます！技術翻訳をされている方ということで心強いです。
"Escape Hatches" 以外のまだ訳されていないセクションを自由に訳していただければと思います。

用語が合っているか既存の訳と照らし合わせたいようなら "Installation" から、そうでなければ "Adding Interactivity", "Managing State", "Quick Start" のいずれかを選んで頂くと良いと思います！

上のチェックリストも更新しておきます。

@no-yan
Copy link
Author

no-yan commented Mar 28, 2022

場合によっては、React 18用の大規模なドキュメント更新がこちらより優先されるかもしれません。
以下のドラフトがマージされて以降になりますが、そちらもご助力いただければ！
reactjs/react.dev#4499

@smikitky
Copy link
Member

@pasteisdenata @no-yan すみません気付いていませんでした…。

React 18 用の大規模マージについては認識はしています。これはむしろ私（メンテナ）の方でやります（影響範囲大きそうすぎるので逆に自分で確認しながら進めたい）。

ベータドキュメントについても、現時点ではワークフローの準備が整っていないため大々的に進めていない状態です。ただ上記に書いてある技術的問題は概ね解決しそうですので、これから改めて進めていきたいと思っています。ひとまず上記でチェックのついていないものならどれからやっていただいても大丈夫ですが、重複作業を防ぐため、このページで着手するという宣言だけしてください。

なお、本家の方でも新ドキュメントの作業が結構遅れておりこんなことを言われている状況です。恐らく React 18 のリリースも終わったので進み始めるだろうとは思っているのですが、いろいろ流動的なところがある点についてはご了承ください。

@pasteisdenata
Copy link
Contributor

@smikitky @no-yan レスポンスが遅れてしまい申し訳ありません。では、Adding Interactivity から開始しますね。取り急ぎ。

@pasteisdenata
Copy link
Contributor

@smikitky Responding to Events の翻訳を始めます。

@gaearon
Copy link
Member

gaearon commented Apr 20, 2023

Hi folks,

Just a heads-up that we've done our best to bring main and legacy branches up-to-date with upstream. This brings you to the latest visual design and sets up all the redirects. We don't anticipate more changes necessary on legacy. For main, there's a few things you need to be aware of:

  • Keep in mind translating UI is best done closer to the end. We plan to make non-trivial code changes to the repo over the next few months. So it's best to focus on the content rather than on UI components.
  • The homepage is untranslated so ideally it would be good if you could do a pass at that. For now, unfortunately it requires messing with the code file.
  • A few rewritten pages (from Installation) are currently untranslated.
  • This was a massive PR to merge, so we might have regressed somewhere or missed some changes that needed to be translated. Ideally, it would be great if you could go over the already-translated pages at your own pace and verify nothing important got lost.

Thank you so much for your cooperation!

@gaearon
Copy link
Member

gaearon commented Apr 20, 2023

With legacy, there's some inconsistencies with how the red banners are displayed/translated. Sorry about that. We've added them manually where they were missing, but they might need a manual pass to make it nicer.

@gaearon gaearon changed the title [Beta] Translation progress checklist New Translation Progress Checklist Apr 25, 2023
@gaearon
Copy link
Member

gaearon commented Apr 25, 2023

I've updated the task list to match our main template.

@gaearon
Copy link
Member

gaearon commented Apr 25, 2023

@smikitky Is the maintainer list in https://github.com/reactjs/translations.react.dev still accurate? If not, would you mind sending a PR that brings it up to date? Thanks!

@smikitky
Copy link
Member

@gaearon Yes it's accurate, thanks!

@smikitky smikitky added help wanted Extra attention is needed and removed beta labels May 17, 2023
@smikitky smikitky mentioned this issue May 22, 2023
Merged
@yuta-ike
Copy link
Contributor

こんにちは。
API ReferenceのuseStateのページを取り組んでも大丈夫でしょうか。

@smikitky
Copy link
Member

@yuta-ike ありがとうございます。

  • 詳しく読んでいないのですがこちらの state 紹介記事やその後の数記事と同じコラムや文章がまるごと文章がコピーされていたりすることがあるので、その場合はそちらから訳文をコピーしていただけると助かります。
  • PR を作る前に main をマージするか main にリベースしてください。こちらの Wiki で説明している textlint 関係の更新が含まれています。

@yuta-ike
Copy link
Contributor

yuta-ike commented Jun 2, 2023 •
edited
Loading

Escape Hatches > Lifecycle of Reactive Effects のページの翻訳を行います。

@kotaesaki
Copy link
Contributor

はじめまして。
Escape Hatches > Separating Events from Effectsのページに取り組んでもよろしいでしょうか？

@sbasken
Copy link
Contributor

sbasken commented Jun 8, 2023 •
edited
Loading

初めまして😄　ソフトウェアエンジニア＆翻訳をしているものです。スタートアップのアプリのローカライゼーションと、オープンソースは、freeCodeCamp.org で Crowdin と 主に Trello を使った翻訳作業を今年３月からしています。すでに fork はしました。優先的に翻訳した方が良いページはありますか？

@smikitky
Copy link
Member

smikitky commented Jun 9, 2023

@sbasken ありがとうございます。どこからでも構わないのですが、需要が高いのはフックリファレンスかなと思います。短いのから始めたい場合は useId などの learn セクションでカバーされていないもの、がっつりやる場合は useContext などは如何でしょう。

@sbasken
Copy link
Contributor

sbasken commented Jun 9, 2023 •
edited
Loading

@smikitky フックリファレンスの useId から取り掛かってみます！ありがとうございます😊

@yuta-ike
Copy link
Contributor

@smikitky useRef の翻訳を行います。

@sbasken
Copy link
Contributor

sbasken commented Jun 26, 2023

@smikitky useImperativeHandle のページの翻訳に取り組んでもいいでしょうか？

@jp-knj jp-knj mentioned this issue Jul 16, 2023
Merged
@jp-knj
Copy link
Contributor

jp-knj commented Jul 16, 2023

<Fragment> (<>) を翻訳を行います。

@smikitky
Copy link
Member

@locol23 ありがとうございます。useReducer でよろしくお願いします。

@natsuokawai
Copy link
Contributor

React APIのインデックスページとcreateContextの翻訳を行います

@natsuokawai
Copy link
Contributor

natsuokawai commented Jul 19, 2023 •
edited
Loading

React API の memo の翻訳を行います
cf: #452 (comment)

@smikitky
Copy link
Member

@natsuokawai もう作業をされていますか？　実は memo は useMemo と記載が被っている部分が結構あり（特に "Should you add memo everywhere?" の部分）、できれば同じ方に翻訳してもらうのがいいかなと思って少し後回しにしていました。

@natsuokawai
Copy link
Contributor

@smikitky
いえ、まだです。そういった背景があって残っていたのですね。
そうしましたら上記のコメントは取り消しておきます。

@smikitky
Copy link
Member

@yuta-ike 上記の通りなのですが、useMemo が終わったあとに memo をお願いしても大丈夫でしょうか。特に急ぎません。

@yuta-ike
Copy link
Contributor

@smikitky 承知しました👍

@Hayao0819
Copy link
Contributor

@smikitky react-dom Componentsのoptionの翻訳を行っても良いでしょうか？

@sbasken
Copy link
Contributor

sbasken commented Jul 21, 2023

@smikitky react-dom: Components の　<input>　の翻訳を行います。

@natsuokawai
Copy link
Contributor

react-dom: Components の <progress> の翻訳を行います。

@ainoshment
Copy link
Contributor

ainoshment commented Jul 24, 2023 •
edited
Loading

@smikitky こんばんは。 react-dom: Components の <select> の翻訳に取り組んでみてもよろしいでしょうか？

@smikitky
Copy link
Member

smikitky commented Aug 8, 2023

renderToX 系はコピペがすごそうなので1名でやります

@jp-knj
Copy link
Contributor

jp-knj commented Aug 12, 2023 •
edited
Loading

react-dom: APIs の findDOMNode の翻訳を行ってもよろしいでしょうか？
他に推奨があれば、そちらをすすめます

@riku929hr
Copy link
Contributor

@smikitky
はじめまして。react-dom: APIs の hydrate の翻訳を行ってもよろしいでしょうか？

@riku929hr riku929hr mentioned this issue Aug 16, 2023
Merged
@smikitky smikitky unpinned this issue Aug 26, 2023
@smikitky smikitky pinned this issue Aug 27, 2023
@smikitky
Copy link
Member

@Hayao0819 <option> の翻訳はどんな感じでしょうか。もう残り記事も少ないですし、こちらで引き取ることも可能です。

@Hayao0819
Copy link
Contributor

@smikitky すみませんすっかり忘れていました。本当に申し訳ないです。そちらでお願いしてもよろしいでしょうか？

@locol23
Copy link
Contributor

locol23 commented Sep 27, 2023

@smikitky react: APIs の cache の翻訳を行っても良いでしょうか？

@smikitky smikitky removed the help wanted Extra attention is needed label Oct 16, 2023
@smikitky
Copy link
Member

現状の全記事の翻訳 (experimental なのを除く) が終了したので close します！ ありがとうございました！

@smikitky
Copy link
Member

これを close すると https://translations.react.dev/ がうまく動いていないっぽいのでとりあえず reopen します…なぜ…

@smikitky smikitky reopened this Oct 16, 2023
@sbasken
Copy link
Contributor

sbasken commented Oct 16, 2023

@smikitky こちらこそ参加させていただきありがとうございました！勉強になりました😃　膨大な量の翻訳、確認作業お疲れ様でした🎉

@smikitky
Copy link
Member

新しい翻訳が追加されるたびに reopen するのもアレなのでこちらは当面 open にしておきます。

ちなみに translations.react.dev はブラウザから GitHub に以下のような GraphQL クエリを発行してその結果を解析することで動作していました。なのでこれを close してしまうと進行状況が不明になってしまうということのようです。なんという力業…。

GraphQL クエリ 
query($limit: Int!) {
  search(
    type: ISSUE
    query: "org:reactjs Translation Progress in:title is:open"
    first: $limit
  ) {
    nodes {
      ... on Issue {
        title
        body
        createdAt
        lastEditedAt
        number
        repository {
          name
        }
      }
    }
  }
}

@smikitky smikitky mentioned this issue May 1, 2024
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests