From 6ef1fa4618e08426b874529619a66adbd3d1fcf0 Mon Sep 17 00:00:00 2001 From: Florian Merz Date: Thu, 11 Feb 2021 12:07:59 +0100 Subject: unslug ja: move --- .../browser_information_resources/index.html | 67 ---------------------- .../cross-team_collaboration_tactics/index.html | 64 --------------------- .../requesting_elevated_privileges/index.html | 24 -------- 3 files changed, 155 deletions(-) delete mode 100644 files/ja/mdn/contribute/processes/browser_information_resources/index.html delete mode 100644 files/ja/mdn/contribute/processes/cross-team_collaboration_tactics/index.html delete mode 100644 files/ja/mdn/contribute/processes/requesting_elevated_privileges/index.html (limited to 'files/ja/mdn/contribute/processes') diff --git a/files/ja/mdn/contribute/processes/browser_information_resources/index.html b/files/ja/mdn/contribute/processes/browser_information_resources/index.html deleted file mode 100644 index 9338fc48eb..0000000000 --- a/files/ja/mdn/contribute/processes/browser_information_resources/index.html +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: ブラウザー特有の情報源 -slug: MDN/Contribute/Processes/Browser_information_resources -tags: - - Guide - - MDN Meta - - Processes - - ガイド - - プロセス -translation_of: MDN/Contribute/Processes/Browser_information_resources ---- -

{{MDNSidebar}}

- -

各ブラウザーの開発元では、ソフトウェアの開発、課題の追跡、議論の記録のために、様々なツールや手法を用いています。この記事では、 MDN のドキュメントを書いたり、互換性に関するデータを MDN に提供したりする際に役立つ、主要なブラウザーごとのツールや情報源を列挙しています。

- -

Chrome

- -

コンテンツ作成中...

- -

Edge

- -

コンテンツ作成中...

- -

Firefox

- -

Mozilla は常にすべての詳細を簡単に見つけられるようにしているわけではありませんが、 Firefox プロジェクトに関する基本的なことはすべてオープンな状態で行われているので、すべてのものが公開されています。 Firefox のすべてのリリースのソースコードには、昔、 Netscape から最初にフォークされたときまでさかのぼって完全にアクセスすることができます。 Mozilla のバグデータベースにもアクセスすることができます。メーリングリストや Mozilla の Discourse サーバー、 IRC チャンネルでの議論にアクセスできます。ソフトウェアの更新が作成され、議論され、最終的にソースリポジトリにマージされたときに、レビューノートの交換にアクセスすることができます。

- -

重要なのは、必要な情報をすべての情報から正確に切り分けることです。目の前に広がっているのは、 Mozillian たちが皮肉を込めて「Mozilla の火の海」と呼んでいる、広大なものです。利用可能な様々なリソースのそれぞれから何を学べるのかを説明するのではなく、学ぶことができるようになるために必要なものを見つけ、求める答えを見つけることができる利用可能なリソースを通る道を特定してみましょう。

- -

ソースコード

- -

Mercurial を介してソースコードにアクセスする通常の方法に加えて、ローカルコピーを手元に置かずにソースコード内の情報を検索する方法があります。

- -

DXR

- -

ソースコードに素早くアクセスする最も簡単な方法は DXR を使うことで、これは Mozilla のソースツリー全体を閲覧して強力な検索を行うことができます。他のツリーに切り替えるオプションもあるので、過去のブランチにさかのぼって見ることができ、たとえば mozilla1.9.2 は Firefox 3.6 に対応します。また、 Firefox ESR の各リリースのコードを見ることもできます。

- -

検索は特殊な演算子に対応しています。例えば、"connect" という単語を検索することはできますが、 "connect file:.webidl" を使うと、 WebIDL ファイルのみを考慮して検索することができます。

- -

Firefox の統合リポジトリ

- -

Firefox のソースコードにアクセスするもう一つの便利な方法が Mozilla 統合リポジトリ (mozilla-unified リポジトリ) です。このリポジトリには、Firefox 3 に対応する Gecko 1.9 までの Firefox のソース履歴があります。興味のあるバージョンに対応する Mercurial タグを見つけることで、特定のバージョンの Firefox のソースコードを見ることができます。 DXR では、いくつかの非常に古いバージョンの Firefox を見ることができますが、ほとんどのバージョンを見る方法は提供されていないので、これは貴重なものです。このリポジトリではすべてのリリースを見ることができます。

- -

タグの命名システムは時間の経過とともにあちこちで変更されているので、探しているものを見つけるにはちょっとした探索が必要になります。原則として、次のようなタグを探してください。

- - - -

特定のリリースを確認したら、通常のツールを使ってコードを閲覧したり検索したり、 changelog と pushlog オプションを使って、リリースにどのような変更が加えられたかを確認することができます。

- -

Searchfox

- -

Searchfox のウェブサイトでは、Firefox のソースコードを検索するための別の方法を提供しています。 Searchfox は Firefox のリポジトリをインデックス化するツールです (最も便利なのは、メインの mozilla-central ソースコード と、興味深いことに WHATWG HTML 仕様書もインデックス化されていることです)。

- -

Opera

- -

コンテンツ作成中...

- -

Safari

- -

コンテンツ作成中...

diff --git a/files/ja/mdn/contribute/processes/cross-team_collaboration_tactics/index.html b/files/ja/mdn/contribute/processes/cross-team_collaboration_tactics/index.html deleted file mode 100644 index 70ca0612ad..0000000000 --- a/files/ja/mdn/contribute/processes/cross-team_collaboration_tactics/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: 文書作成のためのチーム間協力作戦 -slug: MDN/Contribute/Processes/Cross-team_collaboration_tactics -tags: - - Collaborating - - Guide - - MDN Meta - - Processes -translation_of: MDN/Contribute/Processes/Cross-team_collaboration_tactics ---- -
{{MDNSidebar}}
- -

私たちが MDN で学んだことのひとつは、開発チームと文書作成チームが共にあるプロジェクト、API、またはある技術について密接に協力して文書を作成した場合、その文書の品質が素晴らしいということです。このガイドは開発者と文書作成者が手と手を取って協力するための戦略を示唆するものです。

- -
-

この記事は今も作成中の、生きた文書です。もしもあなたの関わる開発者/文書作成者の協力の過程で別の方法を見出したなら、是非ここにそのアイディアを追加してください!

-
- -

つながり始める

- -

理想的には、新しいテクノロジーやプロジェクトが開発され始める時に、開発チームはライターチームに対し文書化の必要のある何かが出てくると知らせるでしょう。ときどきそうはならず、MDNチームはBugzillaを監視して文書化が必要な成果がないのか見ています。しかし完全な世界では、直接的な方法で進歩していきます。

- -

MDN チームに新プロジェクトを知らせるための最良な方法は文書化リクエストのバグを報告することです。 質問の問い合わせ先のリストがあると助かります! プロジェクトに関連するバグのリンクが入っていてもとても助かります。

- -

情報を共有する

- -

情報共有の便利な方法がいくつかあります。このようなものです。

- -

バグ

- -

単に文書化チームに文書化に影響するバグでフラグを立てることですごく助かります。dev-doc-needed キーワードとコメントタグを適切に使すうのは長くかかることもあります。詳細は文書を最新化するを見てください。

- -

ミーティング

- -

開発チームは通常ミーティングをします。それが可能で役立つときには (役立つ場面は多いです)、MDN チームはミーティングに誰かを出席させようとします。何が起きているか、スケジュールはどうか、などを知るのは良い方法です。

- -

加えて、ライターは大きな文書化エリア(例えば Web API 文書)で作業し、その文書化の状況のためだけにミーティングすることもしばしばあります。ライターは開発チーム代表がこうしたミーティングに出るのを好感します; 関係する全員にとって極めて有益です。

- -

典型的にこれは短いチェックインのミーティングで、次のようなアジェンダを伴います:

- -
    -
  1. 貢献するライターの短い状況更新。
    2. -
  2. 開発チームからライターへの質問/更新: 特定文書の状況の質問や、特に急ぐ特定コンテンツの情報や、既存コンテンツの問題への注意などを含みます。
    3. -
  3. ライターから開発チームへの質問/更新: 特定のバグがもうすぐ解決しそうか否かとか、特定の文書のレビューが可能になったりするかとか、ある API の質問に答えられるエンジニアがいるのかどうかとか、ライターがそんな種類の質問をできるチャンスです。
    4. -
- -

Developer Content Coordination Meeting は毎週火曜日の太平洋時間 9 AM に、Vidyo テレビ会議システムの "mdn" チャンネル (音声のみもあり)で開催されます。このミーティングでは、MDNライターコミュニティ、開発関係チーム、API ドキュメントチーム、その他が集まって作業がどこまで進んだかや、何が出てきたかや、開発者と共有すべき最重要事項は何かといった情報交換を行います。これにより、全員がプロモーションの優先度やトピックの文書化のための同じページに乗ることができて、開発者にとって役立つ方法で知らせることのできるフィートバックを返すことにもなります。全員がそこから多くを得て、通常は30分か、少ないかくらいの時間で終わります。

- -

集中作業週間

- -

開発チームに集中作業週間やミートアップがあれば、関連ドキュメントのライターの招待を真剣に考えるべきです。これは多くの利益があり、次のようなものです:

- - - -

集中作業週間があって、あなたのトピック領域の担当のライターがいるかどうかわからない場合、ドキュメントチームのリーダーにeメールしてください(Jean-Yves Perrier まで)、そして彼が誰か派遣できるか確認します。行ける人を探します (あるいは、もっと良い場合、あなたのプロジェクト担当のライターのことも)! ただ覚えてほしいのは、しかしライティングチームは小さく、集中作業週間に参加できる人がちょっとした注意で見つかることはトリッキーです。

- -

文書化の状態を表示するページ

- -

MDN の大き目の文書化プロジェクトでは文書化ステータスページを使って、作業を完了させるのに何をしないといけないか、また何がすでに完了しているか、追跡しています。このページは達成する必要があるタスクと、各タスクのステータスとを一覧にしています。

diff --git a/files/ja/mdn/contribute/processes/requesting_elevated_privileges/index.html b/files/ja/mdn/contribute/processes/requesting_elevated_privileges/index.html deleted file mode 100644 index 85cce731eb..0000000000 --- a/files/ja/mdn/contribute/processes/requesting_elevated_privileges/index.html +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: 上位権限の申請 -slug: MDN/Contribute/Processes/Requesting_elevated_privileges -tags: - - Guide - - MDN Meta - - Processes - - ガイド - - 手続 -translation_of: MDN/Contribute/Processes/Requesting_elevated_privileges ---- -
{{MDNSidebar}}
- -

MDN の一部のツールや操作では、通常のユーザーでは利用できない昇格したアクセス権限が必要です。

- -

ツール使用の権限が欲しい、または必要な場合には以下の手順に従ってください。

- -
    -
  1. mdn-admins@mozilla.org へ (英語で) メールを書き、何が必要かと、その理由をも説明してください。 MDN アカウント名を書いてください。
    2. -
  2. 権限を求めるそれぞれのツールについて、なぜあなたがその権限を得る条件を満たしているのかを説明していることを確認してください。分からない点は、そのツールの「この権限を得る条件」の節を参照してください。
    3. -
  3. 申請が承認されると、 MDN 管理者の一人がそのツールに必要な権限を付与します。
    4. -
- -

誤った使用、濫用、重大な問題 (ツールに危険なバグが新たに発見された等) があった場合は、管理者がツールへのアクセスを停止することがあります。

-- cgit v1.2.3-54-g00ecf