Helpinghands

OpenSource.microsoft.com

Situs web opensource.microsoft.com adalah informasi yang berbagi situs web yang sederhana dan faktual tentang program open source Microsoft, ekosistem open source yang kami dukung, dan peluang untuk terlibat dalam proyek dan mempelajari lebih lanjut.

Situs ini dihasilkan oleh Jekyll, generator situs statis open source populer yang diimplementasikan di Ruby (halaman Jekyll Powers GitHub). Ini digunakan ke Microsoft Azure dalam cluster Linux Azure Kubernetes Service (AKS), dan juga memanfaatkan pintu depan Azure dan Azure CDN. Data dinamis diambil melalui backend node.js yang diimplementasikan dalam naskah.

Dibuat oleh Microsoft Open Source Programs Office (OSPO), bagian dari tim One Engineering System (1ES), kami meluncurkan situs pada Agustus 2020, mengganti versi kuno. Kami berharap pembaruan dan kontribusi ke situs akan dibuat oleh tim Microsoft untuk menampilkan proyek baru dan menarik, memperbarui posting blog yang dikuratori, dan meningkatkan halaman program dan ekosistem.

Kami saat ini tidak memiliki rencana untuk menambahkan bagian yang berbeda secara drastis ke situs atau menjadi "sumber kebenaran" untuk posting blog atau konten lainnya. Kami dapat menerima beberapa kontribusi atau saran terkoordinasi, tetapi meminta koordinasi dalam masalah sebelum memulai fungsionalitas baru, karena situs tersebut memiliki serangkaian persyaratan untuk dipenuhi seperti menjadi WCAG 2.1 dapat diakses, dan digunakan ke cloud Microsoft.

Navigasi situs utama adalah:

• Tinjauan Beranda
• Terlibat
• Proyek
• Ekosistem
• Program kami

Konten lain termasuk:

• Pekerjaan (tautan eksternal)
• Blog (tautan eksternal)
• Kode Perilaku Teks
• Sumber Daya Komunitas
• halaman "terima kasih" tentang sumber terbuka yang memberi daya pada proyek
• OpenAtMicrosoft Twitter
• Repositori ini

Berkontribusi

Kode Etik

Proyek ini telah mengadopsi kode perilaku open source Microsoft. Untuk informasi lebih lanjut, lihat FAQ Kode Perilaku atau hubungi [email protected] dengan pertanyaan atau komentar tambahan.

CLA

Proyek ini menyambut kontribusi dan saran. Sebagian besar kontribusi mengharuskan Anda untuk menyetujui perjanjian lisensi kontributor (CLA) yang menyatakan bahwa Anda memiliki hak untuk, dan benar -benar melakukannya, beri kami hak untuk menggunakan kontribusi Anda. Untuk detailnya, kunjungi https://cla.opensource.microsoft.com.

Saat Anda mengirimkan permintaan tarik, bot CLA akan secara otomatis menentukan apakah Anda perlu memberikan CLA dan menghiasi PR secara tepat (misalnya, pemeriksaan status, komentar). Cukup ikuti instruksi yang disediakan oleh bot. Anda hanya perlu melakukan ini sekali di semua repo menggunakan CLA kami.

Skenario Kontribusi

Terima kasih atas minat Anda untuk berkontribusi pada situs web https://opensource.microsoft.com. Pastikan untuk mengkomunikasikan ide kontribusi apa pun sebagai masalah sebelum memulai permintaan tarik. Kami ingin melihat cara terbaik untuk melibatkan Anda.

Kami senang bahwa situs ini adalah open source (karena situs tentang open source harus open source).

Sebagai situs yang menghadap publik yang di-host di microsoft.com , kami mungkin tidak dapat menerima kontribusi umum ke situs ini, sehingga permintaan tarik Anda mungkin ditutup dan tidak digabungkan, bahkan jika itu hebat, dan kami mungkin tidak dapat memberikan konteks lengkap untuk keputusan tersebut.

Terima kasih atas pengertian Anda.

Merek dagang

Proyek ini dapat berisi merek dagang atau logo untuk proyek, produk, atau layanan. Penggunaan resmi merek dagang atau logo Microsoft tunduk dan harus mengikuti pedoman merek dagang & merek Microsoft. Penggunaan merek dagang atau logo Microsoft dalam versi yang dimodifikasi dari proyek ini tidak boleh menyebabkan kebingungan atau menyiratkan sponsor Microsoft. Setiap penggunaan merek dagang atau logo pihak ketiga tunduk pada kebijakan pihak ketiga tersebut.

Telemetri

Secara default, proyek ini tidak termasuk telemetri ; Namun, tindakan GitHub dapat menghasilkan versi produksi situs tanpa modifikasi.

Ketika lingkungan pembuatan Jekyll diatur ke nama lingkungan produksi Microsoft - "OpenSource.microsoft.com" - Kepatuhan Cookie Standar Microsoft dan kode analitik untuk terhubung dengan wawasan aplikasi termasuk dalam situs.

• Pengumpulan data . Perangkat lunak ini dapat mengumpulkan informasi tentang Anda dan penggunaan perangkat lunak Anda dan mengirimkannya ke Microsoft. Microsoft dapat menggunakan informasi ini untuk menyediakan layanan dan meningkatkan produk dan layanan kami. Anda dapat mematikan telemetri seperti yang dijelaskan dalam repositori. Ada juga beberapa fitur dalam perangkat lunak yang memungkinkan Anda dan Microsoft mengumpulkan data dari pengguna aplikasi Anda. Jika Anda menggunakan fitur -fitur ini, Anda harus mematuhi hukum yang berlaku, termasuk memberikan pemberitahuan yang tepat kepada pengguna aplikasi Anda bersama dengan salinan Pernyataan Privasi Microsoft. Pernyataan privasi kami terletak di https://go.microsoft.com/fwlink/?linkid=824704. Anda dapat mempelajari lebih lanjut tentang pengumpulan data dan penggunaan dalam dokumentasi bantuan dan pernyataan privasi kami. Penggunaan perangkat lunak Anda beroperasi sebagai persetujuan Anda untuk praktik -praktik ini.

Perkembangan

Berkembang dengan codespace

Jalankan perintah ini di codespace Anda:

bundle
npm install
bundle exec jekyll serve

Kemudian editor harus mengarahkan Anda untuk pergi ke port yang diteruskan untuk menguji.

Berkembang secara lokal

Pastikan Anda memiliki salinan Ruby, Node.js, dan Gulp yang berfungsi.

bundle
npm install
gulp
bundle exec jekyll serve

Dockerfile tersedia untuk meng -host versi nginx lokal dari situs statis, meskipun fitur situs dinamis tidak tersedia saat menjalankan lokal, dan Gulp saat ini tidak dijalankan dalam wadah.

Tindakan GitHub

Repo ini menggunakan tindakan GitHub untuk beberapa tujuan.

Membangun

Bangunan utama dari cabang main menciptakan versi statis situs dan menyimpannya sebagai artefak. Ini dilakukan dengan menggunakan wadah Docker khusus untuk lingkungan build ini Inc. Permata ruby, paket simpul, dll.

Tarik permintaan

Pementasan terpisah dapat dikonfigurasi untuk menggunakan versi situs ini, jika pemelihara proyek menyetujuinya, menggunakan komentar termasuk frasa /startContentBuild .