Helpinghands

opensource.microsoft.com

opensource.microsoft.com Webサイトは、Microsoftのオープンソースプログラム、私たちがサポートするオープンソースのエコシステム、プロジェクトに参加して詳細を学ぶ機会に関する情報を共有するシンプルで事実上のWebサイトです。

このサイトは、Ruby（Jekyll Powers Githubページ）に実装されている人気のあるオープンソースの静的サイトジェネレーターであるJekyllによって生成されます。 Linux Azure Kubernetesサービス（AKS）クラスター内のMicrosoft Azureに展開され、Azureの正面玄関とAzure CDNも使用しています。動的データは、TypeScriptに実装されたnode.jsバックエンドを介して取得されます。

One Engineering System（1ES）チームの一部であるMicrosoft Open Source Programs Office（OSPO）によって作成され、2020年8月に時代遅れのバージョンを置き換えてサイトを立ち上げました。サイトへの更新と貢献は、Microsoftチームが新しい興味深いプロジェクトを紹介し、キュレーションされたブログ投稿を更新し、プログラムとエコシステムのページを改善するために行われると予想しています。

現在、サイトに大幅に異なるセクションを追加したり、ブログ投稿やその他のコンテンツの「真実のソース」になる計画はありません。いくつかの調整された貢献や提案を受け入れることができますが、新しい機能に着手する前に問題の調整を要求します。サイトには、WCAG 2.1にアクセス可能であるなど、Microsoftのクラウドに展開するなどの一連の要件があるためです。

主要なサイトナビゲーションは次のとおりです。

• ホームページの概要
• 参加してください
• プロジェクト
• 生態系
• 私たちのプログラム

その他のコンテンツは次のとおりです。

• ジョブ（外部リンク）
• ブログ（外部リンク）
• 行動規範テキスト
• コミュニティリソース
• プロジェクトに電力を供給するオープンソースに関する「ありがとう」ページ
• OpenAtMicrosoft Twitter
• このリポジトリ

貢献

行動規範

このプロジェクトは、Microsoftのオープンソース行動規範を採用しています。詳細については、FAQのコードを参照するか、追加の質問やコメントについては[email protected]にお問い合わせください。

CLA

このプロジェクトは、貢献と提案を歓迎します。ほとんどの貢献では、貢献者ライセンス契約（CLA）に同意する必要があります。詳細については、https：//cla.opensource.microsoft.comをご覧ください。

プルリクエストを送信すると、CLAボットはCLAを提供し、PRを適切に飾る必要があるかどうかを自動的に決定します（たとえば、ステータスチェック、コメント）。ボットが提供する指示に従うだけです。 CLAを使用して、すべてのレポでこれを1回だけ行う必要があります。

貢献シナリオ

https://opensource.microsoft.comのWebサイトに貢献してくれてありがとう。プルリクエストを開始する前に、貢献アイデアを問題として必ず伝えてください。私たちはあなたを最もよく巻き込む方法を見たいです。

このサイトがオープンソースであることを嬉しく思います（オープンソースに関するサイトはオープンソースである必要があるためです）。

microsoft.comでホストされている公開サイトとして、このサイトへの一般的な貢献を受け入れることができない可能性があるため、たとえそれが素晴らしいとしても、プルリクエストが閉じられ、マージされない可能性があり、そのような決定のために完全なコンテキストを提供できない場合があります。

ご理解いただきありがとうございます。

商標

このプロジェクトには、プロジェクト、製品、またはサービスの商標またはロゴが含まれる場合があります。 Microsoftの商標またはロゴの承認された使用は、Microsoftの商標およびブランドガイドラインに従うものであり、従わなければなりません。このプロジェクトの変更されたバージョンでのMicrosoft商標またはロゴの使用は、混乱を引き起こしたり、Microsoftのスポンサーシップを暗示したりしてはなりません。サードパーティの商標またはロゴの使用は、これらのサードパーティのポリシーの対象となります。

テレメトリー

デフォルトでは、このプロジェクトにはテレメトリが含まれていません。ただし、GitHubアクションは、変更なしでサイトの生産バージョンを生成する場合があります。

Jekyllビルド環境がMicrosoftの生産環境名に設定されている場合、「OpenSource.microsoft.com」 - Microsoftの標準的なCookieコンプライアンスおよび分析コードがアプリケーションの洞察に接続することがサイトに含まれています。

• データ収集。ソフトウェアは、お客様とソフトウェアの使用に関する情報を収集し、Microsoftに送信する場合があります。 Microsoftは、この情報を使用してサービスを提供し、製品とサービスを改善する場合があります。リポジトリに記載されているように、テレメトリをオフにすることができます。また、ソフトウェアには、お客様とマイクロソフトがアプリケーションのユーザーからデータを収集できるようにする機能もあります。これらの機能を使用する場合は、Microsoftのプライバシーステートメントのコピーとともに、アプリケーションのユーザーに適切な通知を提供するなど、適用法に従う必要があります。プライバシーステートメントは、https：//go.microsoft.com/fwlink/?linkid=824704にあります。ヘルプのドキュメントとプライバシーステートメントで、データ収集と使用の詳細をご覧ください。ソフトウェアの使用は、これらのプラクティスへの同意として機能します。

発達

コードスペースで開発

これらのコマンドをCodeSpaceで実行します。

bundle
npm install
bundle exec jekyll serve

その後、編集者は、テストのために転送されたポートに行くように指示する必要があります。

ローカルで開発

Ruby、node.js、Gulpの作業コピーがあることを確認してください。

bundle
npm install
gulp
bundle exec jekyll serve

Dockerfile 、静的サイトのローカルnginxバージョンをホストするために利用できますが、ローカルを実行するときは動的なサイト機能は使用できず、現在はコンテナでGulpが実行されていません。

githubアクション

このレポは、いくつかの目的でGitHubアクションを使用します。

建てる

mainブランチからの主要なビルドは、サイトの静的バージョンを作成し、アーティファクトとして保存します。これは、このBuild Environment Incに固有のDockerコンテナを使用して行われます。ルビージェム、ノードパッケージなど。

リクエストをプルします

プロジェクトのメンテナーが承認した場合、このサイトのバージョン/startContentBuild使用するように別のステージングを構成することができます。