Helpinghands

opensource.microsoft.com

Веб -сайт opensource.microsoft.com представляет собой простую, фактическую информацию об обмене веб -сайтами о программе Microsoft с открытым исходным кодом, экосистеме с открытым исходным кодом, которую мы поддерживаем, и возможности принять участие в проектах и ​​узнать больше.

Сайт генерируется Jekyll, популярным статическим генератором сайта с открытым исходным кодом, реализованным в Ruby (Jekyll Powers Github Pages). Он развернут в Microsoft Azure в кластере Linux Azure Kubernetes (AKS), а также использует входную дверь Azure и CDN Azure. Динамические данные получены через бэкэнд node.js, реализованный в TypeScript.

Созданная Microsoft Open Source Programs Office (OSPO), часть команды One Engineering System (1ES), мы запустили сайт в августе 2020 года, заменив устаревшую версию. Мы ожидаем, что обновления и вклады на сайт будут внесены командами Microsoft, чтобы представлять новые и интересные проекты, обновить кураторские сообщения в блоге и улучшить страницы программ и экосистем.

В настоящее время у нас нет планов, чтобы добавить к сайту радикально разные разделы или быть «источником истины» для постов в блоге или другого контента. Мы можем принять некоторые скоординированные взносы или предложения, но запросить координацию в вопросах, прежде чем приступить к новой функциональности, поскольку на сайте есть набор требований, такие как доступ к WCAG 2.1 и развертывание в Microsoft Cloud.

Основная навигация на сайте:

• Обзор домашней страницы
• Принять участие
• Проекты
• Экосистема
• Наша программа

Другой контент включает в себя:

• Задания (внешняя ссылка)
• Блог (внешняя ссылка)
• Текст кода поведения
• Общественные ресурсы
• Страница «Спасибо» о открытом исходном код, питающих проект
• Openatmicrosoft Twitter
• Этот репозиторий

Внося

Нормы поведения

Этот проект принял код поведения с открытым исходным кодом Microsoft. Для получения дополнительной информации см. Кодекс поведения FAQ или свяжитесь с [email protected] с любыми дополнительными вопросами или комментариями.

Класс

Этот проект приветствует вклады и предложения. Большинство взносов требуют, чтобы вы согласились с лицензионным соглашением о участнике (CLA), заявив, что вы имеете право и фактически предоставить нам права на использование вашего вклада. Для получения подробной информации, посетите https://cla.opensource.microsoft.com.

Когда вы отправляете запрос на привлечение, бот CLA автоматически определит, нужно ли вам предоставить CLA и правильно украсить PR (например, проверка состояния, комментарий). Просто следуйте инструкциям, предоставленным ботом. Вам нужно будет сделать это только один раз во всех репо, используя наш CLA.

Сценарии вклада

Спасибо за ваш интерес к веб -сайту https://opensource.microsoft.com. Пожалуйста, не забудьте сообщить о любых идеях взносов в качестве вопроса, прежде чем запустить запрос на привлечение. Мы хотели бы увидеть, как лучше всего вас привлечь.

Мы рады, что этот сайт является открытым исходным кодом (потому что сайт об открытом исходном коде должен быть открытым исходным кодом).

Как публичный сайт, размещенный на microsoft.com , мы не сможем принять общие взносы на этот сайт, поэтому ваш запрос на привлечение может быть закрыт и не объединен, даже если это здорово, и мы не сможем предоставить полный контекст для любого такого решения.

Спасибо за понимание.

Товарные знаки

Этот проект может содержать товарные знаки или логотипы для проектов, продуктов или услуг. Уполномоченное использование товарных знаков или логотипов Microsoft подлежит и должно следовать указаниям Microsoft по товарной марке и брендам. Использование товарных знаков Microsoft или логотипов в модифицированных версиях этого проекта не должно вызывать путаницу или подразумевать спонсорство Microsoft. Любое использование сторонних товарных знаков или логотипов подвержена политике сторонних сторон.

Телеметрия

По умолчанию этот проект не включает телеметрию ; Однако действия GitHub могут генерировать производственную версию сайта без модификации.

Когда среда Build Jekyll будет установлена ​​на название производственной среды Microsoft - «opensource.microsoft.com» - стандартный код соответствия требованиям и аналитике Microsoft для подключения к приложениям включен на сайт.

• Сбор данных . Программное обеспечение может собирать информацию о вас и использование программного обеспечения и отправить ее в Microsoft. Microsoft может использовать эту информацию для предоставления услуг и улучшения наших продуктов и услуг. Вы можете отключить телеметрию, как описано в репозитории. В программном обеспечении также есть некоторые функции, которые могут позволить вам и Microsoft собирать данные от пользователей ваших приложений. Если вы используете эти функции, вы должны соблюдать применимый закон, включая предоставление соответствующих уведомлений пользователям ваших приложений вместе с копией выписки Microsoft по конфиденциальности. Наше заявление о конфиденциальности находится по адресу https://go.microsoft.com/fwlink/?linkid=824704. Вы можете узнать больше о сборе данных и использовании в справочной документации и нашем заявлении о конфиденциальности. Использование вашего программного обеспечения работает как ваше согласие на эту практику.

Разработка

Разработка с Codespaces

Запустите эти команды в вашем коде:

bundle
npm install
bundle exec jekyll serve

Затем редактор должен направить вас в перенаправленный порт для тестирования.

Разработка локально

Убедитесь, что у вас есть рабочая копия Ruby, Node.js и Gulp.

bundle
npm install
gulp
bundle exec jekyll serve

Dockerfile доступен для размещения локальной версии nginx статического сайта, хотя динамические функции сайта недоступны при запуске Local, а Gulp в настоящее время не работает в контейнере.

Действия GitHub

Это репо использует действия GitHub для нескольких целей.

Строить

Основная сборка из main ветви создает статическую версию сайта и хранит его как артефакт. Это делается с использованием контейнера Docker, специфичного для этой среды Build Environment Inc. Рубиновые драгоценные камни, пакеты узлов и т. Д.

Получить запросы

Отдельная постановка может быть настроена на использование версии этого сайта, если поддерживающий проект утверждает его, используя комментарий, включая фразу /startContentBuild .