japanese

Author: RuimingShen

contributor_docs/ja/README.md

@@ -0,0 +1,40 @@
+# アクセシビリティに焦点を当てています
+
+[2019年のコントリビューター会議](https://p5js.org/community/contributors-conference-2019.html)で、私たちはp5.jsにアクセシビリティ（包含性及び/またはアクセス可能性）を向上させる機能のみを追加することを約束しました。これは、性別、社会的、経済的、人種的、民族的、言語的、障害などの多様性の側面がアクセシビリティ/参加度にどのように影響するかを考慮し、障害を認識し、取り除き、予防する行動を取ることを意味します。我々は、相対的に特権を持つグループがp5.jsを使用する際の快適さを高めるためではなく、歴史的に疎外されたグループのニーズを優先します。
+
+アクセシビリティ努力をサポートしない機能要求は受け入れません。これらの基準は、私たちの問題およびプルリクエストのテンプレートに反映されています。
+
+これはp5.jsのアクセシビリティと包含性についての継続的な対話の一環です。私たちの意図は、これらをp5.js構築の核心的価値観として捉え、これは[2015年のコントリビューター会議](https://p5js.org/community/contributors-conference-2015.html)で作成された[コミュニティ声明](../CODE_OF_CONDUCT.md)で説明されています。
+
+**これを出発点と考えてください。** 私たちは、アクセシビリティが何を意味するのか、そしてどのように優先すべきかについてのさらなる議論を歓迎します。
+
+## アクセシビリティの種類
+
+アクセシビリティを向上させることは、p5.jsコミュニティの人数を増やすことに焦点を当てることではありません。それは、p5.jsコミュニティの外側にいる人々（意図的であれ無意識であれ）および類似のツールやコミュニティの外側にいる人々にとって、p5.jsをより使いやすく、アクセスしやすくすることに焦点を当てています。
+
+ここでのアクセシビリティは、以下の人々のためのp5.jsの改善を意味します：
+
+- 非英語を母国語とする人々
+- 黒人、先住民、有色人種
+- LGBTIQ+の人々
+- 性別で疎外されている人々
+- 障害者または病気の人々
+- クラスや収入の理由で創造的なプログラミングに参加する機会やリソースが不足している人々
+- オープンソースや創造的プログラミングの分野で経験がない、またはほとんどない人々
+- その他、システム的に排除され、歴史的に代表性が不足している人々
+
+### 例
+
+以下は、アクセシビリティを向上させるための取り組みの例です：
+
+- より多くの言語への文書やその他の資料の翻訳
+- 補助技術（例えばスクリーンリーダー）へのサポートの改善
+- 私たちのツール内およびユーザーがプロジェクト内でこれらのガイドラインに従いやすくするためのWebコンテンツアクセシビリティガイドラインの遵守
+- p5.jsのエラーメッセージを使用者にとってより有用でサポートするものにする
+- 創造的プログラミングとデジタルアートのコミュニティで歴史的に疎外され、マイノリティであった人々の間でp5.jsの学習指導とサポート
+
+これら以外にも、私たちがまだ思いついていないことがあります。何かアイデアがあれば、[問題として共有してください](https://github.com/processing/p5.js/issues/new/choose)。
+
+## メンテナンス
+
+私たちは、p5.jsの既存の機能セットのメンテナンスを意図していることも認識しています。私たちは、コードベースのどの部分に現れるかに関わらず、バグを修正したいと考えています。なぜなら、私たちはツールの一貫性が初心者にとってよりアクセスしやすくなると信じているからです。

contributor_docs/ja/access.md

@@ -0,0 +1,38 @@
+# 貢献ドキュメント
+
+参考文献は、初心者と経験豊富なプログラマーの双方にとって不可欠です。それは、p5.jsにあまり慣れていない人々に友情の手を差し伸べ、私たちのコミュニティをより包括的で豊かにするのに役立ちます。また、テストや参考文献の作成時にコード自体の問題を見つけるのにも役立ちます。
+
+参考文献に貢献する方法はいくつかあります：
+
+## ☝️ Open issues
+参考文献に関する問題を解決し始めたい場合は、オープンな問題リスト（open issues）を開き、「documentation」のタグが付けられた問題を探します。誤字、欠落しているまたは破損したドキュメント、または混乱する関数の説明に気づいた場合は、[issueを作成してください](https://github.com/processing/p5.js/issues)！修正が必要なページのリンクを付けてください、そうすることで私たちは簡単に見つけることができます。
+
+## 🗯 参考資料に貢献する
+[参考資料](http://p5js.org/reference/)を注意深く読み、誤字、壊れたり混乱したドキュメントがないか確認してください。簡単な修正であれば、直接修正することができます。議論が必要な問題の場合は、[issueを作成してください](https://github.com/processing/p5.js/issues/new)。
+* これは[p5.jsのコードベースを初めて使用するためのセットアップ](./README.md)の説明です。
+* 参考文献は、ソースコード中のインラインドキュメント（`src/`フォルダー内に見つかります）に基づいて構築されています。
+* これは[インラインドキュメントと例を更新または追加する方法](./inline_documentation.md)に関する情報です。
+* [スペイン語のドキュメント](http://p5js.org/es)に間違いが見つかった場合、[こちら](https://github.com/processing/p5.js-website#internationalization-i18n-and-structure)で更新の指示を見つけることができます。
+* コミュニティがメンテナンスしているTypescript定義は[こちら](https://github.com/p5-types/p5.ts)にあります。
+
+## ✨ サンプルを作る
+参考資料では通常、関数の非常にシンプルなコードスニペットがリストされていますが、より長く、より複雑なサンプルも有用です。
+* 現在、私たちは[processingのサンプルページ](https://processing.org/examples/)から[p5.jsのサンプルページ](http://p5js.org/examples)へのサンプルの移行に取り組んでいます。手伝っていただける場合は、[こちら](https://github.com/processing/p5.js-website/blob/main/contributor_docs/Adding_examples.md)の指示をご覧ください。
+* または、独自のサンプルを作成し、好きな場所で独立して公開することもできます。オンラインで共有したい場合は、[@p5xjs](https://twitter.com/p5xjs)にタグを付けるか、[[email protected]](mailto:[email protected])にメールを送ってください。私たちは広く共有します！オンラインでサンプルを公開する際に役立つかもしれないこの[p5.jsの埋め込みガイド](https://github.com/processing/p5.js/wiki/Embedding-p5.js)をご覧ください。
+* p5.jsにバグを見つけた場合は、[issues](https://github.com/processing/p5.js/issues)に記録してください。
+
+## 👯 チュートリアルを作る
+* p5.jsの初心者であれば、ここから始めることができます。何かを自分で作ってみて、それから他の人に教えるためのチュートリアルを作ってみてください。
+* 現在、私たちは[processingのチュートリアルページ](https://processing.org/tutorials)から[p5.jsの学習ページ](http://p5js.org/learn)へのチュートリアルの移行に取り組んでいます。手伝っていただける場合は、[このチュートリアル](https://p5js.org/learn/tutorial-guide.html)をご覧ください。
+* 異なる主題のチュートリアルも歓迎します。これらのチュートリアルは、どこでも、任意の形式で公開できます。オンラインで共有したい場合は、[@p5xjs](https://twitter.com/p5xjs)にタグを付けるか、[[email protected]](mailto:[email protected])にメールを送ってください。私たちは広く共有します！特定の聴衆や使用例に対して作成されたチュートリアルを非常に奨励しています（例えば：ジャーナリスト、活動家、詩人、子供、高齢者、夢見る人、異なる言語のp5など）。私たちは考えています：まだp5コミュニティで歓迎されていない、または参加していない人は誰ですか？学習を彼らへの招待として使用できますか？どのような言語と聴衆とコミュニケーションを取り、彼らが理解されていると感じさせることができますか？形式に自由に挑戦してください。Sharon De La Cruzの[コーディングスラングに関するプレゼンテーション](https://www.youtube.com/watch?v=CFT6w9NKfCs)からインスピレーションを得ることができます。
+* p5.jsにバグを見つけた場合は、[issues](https://github.com/processing/p5.js/issues)に記録してください。
+
+## 👉 開始する
+* [p5.jsコミュニティ声明](http://p5js.org/community/)を読む
+* オプション：[貢献者ドキュメント](./README.md)を確認して、リポジトリの概要を把握し、コードの構築方法を学ぶ（関連する場合）。
+* すべての議論はGitHubのissueで行われるため、Slack/Gitterなどのチャネルに参加する必要はありません。
+* readme.mdファイルにあなたの名前を[貢献者リスト](https://github.com/processing/p5.js#contributors)に追加してください！手順は[ここ](https://github.com/processing/p5.js/issues/2309)にあります。
+* もちろん、バグ修正が好きであれば、いつでも[issue](https://github.com/processing/p5.js/issues)をクリックしてください！
+
+ようこそ！ここにいてくれて嬉しいです！
+❤️ p5.jsコミュニティ