Helpinghands

opensaurce.microsoft.com

El sitio web opensource.microsoft.com es un sitio web simple y fáctico que comparte información sobre el programa de código abierto de Microsoft, el ecosistema de código abierto que apoyamos y las oportunidades para involucrarse en proyectos y obtener más información.

El sitio es generado por Jekyll, un popular generador de sitios estáticos de código abierto implementado en Ruby (Páginas GitHub de Jekyll Powers). Se implementa en Microsoft Azure dentro de un clúster del servicio de Linux Azure Kubernetes (AKS), y también utiliza la puerta principal de Azure y Azure CDN. Los datos dinámicos se recuperan a través de un backend nodo.js implementado en TypeScript.

Creada por la Oficina de Programas de Open Source de Microsoft (OSPO), parte del equipo de un sistema de ingeniería (1ES), lanzamos el sitio en agosto de 2020, reemplazando una versión anticuada. Esperamos que los equipos de Microsoft realicen actualizaciones y contribuciones al sitio para presentar proyectos nuevos e interesantes, actualizar las publicaciones de blog seleccionadas y mejorar las páginas de programas y ecosistemas.

Actualmente no tenemos planes de agregar secciones drásticamente diferentes al sitio o ser la "fuente de la verdad" para publicaciones de blog u otro contenido. Podemos aceptar algunas contribuciones o sugerencias coordinadas, pero solicitar la coordinación en los problemas antes de embarcarse en una nueva funcionalidad, ya que el sitio tiene un conjunto de requisitos que cumplir, como ser accesible WCAG 2.1 e implementarse en la nube de Microsoft.

La navegación principal del sitio es:

• Descripción general de la página de inicio
• Complicarse
• Proyectos
• Ecosistema
• Nuestro programa

Otro contenido incluye:

• Trabajos (un enlace externo)
• Blog (un enlace externo)
• Texto del código de conducta
• Recursos comunitarios
• Una página de "gracias" sobre el código abierto que alimenta el proyecto
• OpenATMicrosoft Twitter
• Este repositorio

Que contribuye

Código de conducta

Este proyecto ha adoptado el Código de Conducta Open Open Microsoft. Para obtener más información, consulte el Código de Conducta Preguntas frecuentes o comuníquese con [email protected] con cualquier pregunta o comentario adicional.

Tapa

Este proyecto da la bienvenida a las contribuciones y sugerencias. La mayoría de las contribuciones requieren que acepte un Acuerdo de Licencia de Contributor (CLA) que declare que tiene derecho y realmente hacernos los derechos para utilizar su contribución. Para más detalles, visite https://cla.opensource.microsoft.com.

Cuando envíe una solicitud de extracción, un BOT CLA determinará automáticamente si necesita proporcionar un CLA y decorar el PR adecuadamente (por ejemplo, verificación de estado, comentario). Simplemente siga las instrucciones proporcionadas por el bot. Solo necesitará hacer esto una vez en todos los reposos usando nuestro CLA.

Escenarios de contribución

Gracias por su interés en contribuir al sitio web https://opensource.microsoft.com. Asegúrese de comunicar cualquier idea de contribución como un problema antes de comenzar una solicitud de extracción. Nos encantaría ver cómo involucrarte mejor.

Estamos contentos de que este sitio sea de código abierto (porque un sitio sobre código abierto debe ser de código abierto).

Como un sitio público alojado en microsoft.com , es posible que no podamos aceptar contribuciones generales a este sitio, por lo que su solicitud de extracción puede cerrarse y no fusionarse, incluso si es excelente, y es posible que no podamos proporcionar un contexto completo para dicha decisión.

Gracias por tu comprensión.

Marcas registradas

Este proyecto puede contener marcas comerciales o logotipos para proyectos, productos o servicios. El uso autorizado de marcas o logotipos de Microsoft está sujeto y debe seguir las pautas de marca y marca de Microsoft. El uso de marcas registradas de Microsoft o logotipos en versiones modificadas de este proyecto no debe causar confusión o implicar el patrocinio de Microsoft. Cualquier uso de marcas comerciales o logotipos de terceros está sujeto a las políticas de esas partes de terceros.

Telemetría

Por defecto, este proyecto no incluye telemetría ; Sin embargo, las acciones de GitHub pueden generar la versión de producción del sitio sin modificación.

Cuando el entorno de compilación Jekyll se establece en el nombre del entorno de producción de Microsoft - "OpenSource.microsoft.com" - El código de análisis y análisis de cookies estándar de Microsoft para conectarse con la aplicación de la aplicación está incluido en el sitio.

• Recopilación de datos . El software puede recopilar información sobre usted y su uso del software y enviarla a Microsoft. Microsoft puede usar esta información para proporcionar servicios y mejorar nuestros productos y servicios. Puede apagar la telemetría como se describe en el repositorio. También hay algunas características en el software que pueden permitirle a usted y a Microsoft recopilar datos de los usuarios de sus aplicaciones. Si utiliza estas funciones, debe cumplir con la ley aplicable, incluida la proporcionar avisos apropiados a los usuarios de sus aplicaciones junto con una copia de la declaración de privacidad de Microsoft. Nuestra declaración de privacidad se encuentra en https://go.microsoft.com/fwlink/?linkid=824704. Puede obtener más información sobre la recopilación y el uso de datos en la documentación de ayuda y nuestra declaración de privacidad. Su uso del software opera como su consentimiento para estas prácticas.

Desarrollo

Desarrollando con espacios de códigos

Ejecute estos comandos en su CodeSpace:

bundle
npm install
bundle exec jekyll serve

Luego, el editor debe dirigirlo que vaya al puerto reenviado para probar.

Desarrollando localmente

Asegúrese de tener una copia en funcionamiento de Ruby, Node.js y Gulp.

bundle
npm install
gulp
bundle exec jekyll serve

El Dockerfile está disponible para alojar una versión nginx local del sitio estático, aunque las características dinámicas del sitio no están disponibles cuando se ejecuta local, y Gulp no se ejecuta actualmente en el contenedor.

Acciones de Github

Este repositorio utiliza acciones de GitHub para varios fines.

Construir

La construcción principal de la rama main crea la versión estática del sitio y la almacena como un artefacto. Esto se realiza utilizando un contenedor Docker específico para este entorno de compilación inc. Gemas de rubí, paquetes de nodos, etc.

Solicitud de solicitud

Se puede configurar una puesta en escena separada para usar una versión de este sitio, si un mantenedor del proyecto lo aprueba, utilizando un comentario que incluye la frase /startContentBuild .