Helpinghands

opensource.microsoft.com

Le site Web opensource.microsoft.com est un site Web simple et factuel partageant des informations sur le programme open source de Microsoft, l'écosystème open source que nous prenons en charge et les opportunités de s'impliquer dans des projets et d'en savoir plus.

Le site est généré par Jekyll, un générateur de site statique open source populaire implémenté dans Ruby (Jekyll Powers GitHub Pages). Il est déployé sur Microsoft Azure dans un cluster Linux Azure Kubernetes Service (AKS), et utilise également la porte d'entrée Azure et le CDN Azure. Les données dynamiques sont récupérées via un backend Node.js implémenté dans TypeScript.

Créée par le Microsoft Open Source Programs Office (OSPO), faisant partie de l'équipe One Engineering System (1ES), nous avons lancé le site en août 2020, remplaçant une version désuet. Nous nous attendons à ce que les mises à jour et les contributions au site soient faites par les équipes de Microsoft pour présenter de nouveaux projets intéressants, mettre à jour les articles de blog organisés et améliorer les pages du programme et de l'écosystème.

Nous n'avons pas actuellement l'intention d'ajouter des sections radicalement différentes au site ou d'être la "source de vérité" pour les articles de blog ou d'autres contenus. Nous sommes en mesure d'accepter certaines contributions ou suggestions coordonnées, mais demandent la coordination des problèmes avant de se lancer dans de nouvelles fonctionnalités, car le site a un ensemble d'exigences pour répondre à la WCAG 2.1 accessible et en déploiement dans le cloud de Microsoft.

La navigation du site principal est:

• Aperçu de la page d'accueil
• S'impliquer
• Projets
• Écosystème
• Notre programme

Autre contenu comprend:

• Emplois (un lien externe)
• Blog (un lien externe)
• Code de conduite
• Ressources communautaires
• Une page "merci" sur l'open source alimentant le projet
• OpenAtMicrosoft Twitter
• Ce référentiel

Contributif

Code de conduite

Ce projet a adopté le code de conduite open source Microsoft. Pour plus d'informations, consultez le code de conduite FAQ ou contactez [email protected] avec toute question ou commentaire supplémentaire.

CLA

Ce projet accueille les contributions et les suggestions. La plupart des contributions vous obligent à accepter un accord de licence de contributeur (CLA) déclarant que vous avez le droit de faire et en fait, accordez-nous les droits d'utilisation de votre contribution. Pour plus de détails, visitez https://cla.opensource.microsoft.com.

Lorsque vous soumettez une demande de traction, un bot CLA déterminera automatiquement si vous devez fournir un CLA et décorer le RP de manière appropriée (par exemple, vérification d'état, commentaire). Suivez simplement les instructions fournies par le bot. Vous n'aurez besoin de le faire qu'une seule fois sur tous les dépositions en utilisant notre CLA.

Scénarios de contribution

Merci de votre intérêt à contribuer au site Web https://openseource.microsoft.com. Veuillez vous assurer de communiquer toutes les idées de contribution en tant que problème avant de commencer une demande de traction. Nous aimerions voir comment vous impliquer au mieux.

Nous sommes heureux que ce site soit open source (car un site sur l'open source doit être open source).

En tant que site orienté public hébergé sur microsoft.com , nous ne pourrons peut-être pas accepter les contributions générales à ce site, donc votre demande de traction peut être fermée et non fusionnée, même si elle est formidable, et nous ne pouvons pas fournir un contexte complet pour une telle décision.

Merci pour votre compréhension.

Marques

Ce projet peut contenir des marques ou des logos pour des projets, des produits ou des services. L'utilisation autorisée de marques ou de logos Microsoft est soumise et doit suivre les directives de marque et de marque de Microsoft. L'utilisation de marques ou de logos de Microsoft dans des versions modifiées de ce projet ne doit pas provoquer de confusion ou impliquer le parrainage de Microsoft. Toute utilisation de marques ou de logos tiers est soumis aux politiques de ces tiers.

Télémétrie

Par défaut, ce projet n'inclut pas la télémétrie ; Cependant, les actions GitHub peuvent générer la version de production du site sans modification.

Lorsque l'environnement de construction Jekyll est défini sur le nom de l'environnement de production de Microsoft - "OpenSource.microsoft.com" - Le code de conformité et d'analyse des cookies standard de Microsoft pour se connecter avec les informations d'application est inclus dans le site.

• Collecte de données . Le logiciel peut collecter des informations sur vous et votre utilisation du logiciel et les envoyer à Microsoft. Microsoft peut utiliser ces informations pour fournir des services et améliorer nos produits et services. Vous pouvez désactiver la télémétrie comme décrit dans le référentiel. Il existe également certaines fonctionnalités du logiciel qui peuvent permettre à vous et à Microsoft de collecter des données auprès des utilisateurs de vos applications. Si vous utilisez ces fonctionnalités, vous devez vous conformer à la loi applicable, y compris en fournissant des avis appropriés aux utilisateurs de vos applications ainsi qu'une copie de la déclaration de confidentialité de Microsoft. Notre déclaration de confidentialité est située sur https://go.microsoft.com/fwlink/?linkid=824704. Vous pouvez en savoir plus sur la collecte de données et l'utilisation dans la documentation d'aide et notre déclaration de confidentialité. Votre utilisation du logiciel fonctionne comme votre consentement à ces pratiques.

Développement

Développer avec des codespaces

Exécutez ces commandes dans votre codepace:

bundle
npm install
bundle exec jekyll serve

Ensuite, l'éditeur doit vous demander d'aller au port transmis pour tester.

Développer localement

Assurez-vous d'avoir une copie de travail de Ruby, Node.js et Gulp.

bundle
npm install
gulp
bundle exec jekyll serve

Le Dockerfile est disponible pour héberger une version nginx locale du site statique, bien que les fonctionnalités du site dynamique ne soient pas disponibles lors de l'exécution locale, et Gulp n'est pas actuellement exécuté dans le conteneur.

Actions github

Ce repo utilise des actions GitHub à plusieurs fins.

Construire

La construction principale à partir de la branche main crée la version statique du site et la stocke en artefact. Cela se fait à l'aide d'un conteneur Docker spécifique à cet environnement de construction inc. Ruby Gems, Packages de nœuds, etc.

Des demandes de traction

Une stadification distincte peut être configurée pour utiliser une version de ce site, si un responsable du projet l'approuve, en utilisant un commentaire comprenant la phrase /startContentBuild .