Git Product home page Git Product logo

microsoft / opensource.microsoft.com Goto Github PK

View Code? Open in Web Editor NEW
736.0 100.0 344.0 5 MB

This is the source code to the Microsoft Open Source site featuring projects, program information, and "get involved" pages. This site is published at opensource.microsoft.com and managed by the Microsoft Open Source Programs Office (OSPO).

Home Page: https://opensource.microsoft.com

License: MIT License

HTML 37.40% Ruby 0.25% JavaScript 37.30% Shell 0.10% Dockerfile 0.05% SCSS 24.89%
site ospo open-source jekyll

opensource.microsoft.com's Introduction

opensource.microsoft.com

The opensource.microsoft.com web site is a simple, factual web site sharing information about Microsoft's open source program, the open source ecosystem that we support, and opportunities to get involved in projects and learn more.

The site is generated by Jekyll, a popular open source static site generator implemented in Ruby (Jekyll powers GitHub Pages). It is deployed to Microsoft Azure within a Linux Azure Kubernetes Service (AKS) cluster, and also makes use of Azure Front Door and Azure CDN. Dynamic data is retrieved through a Node.js backend implemented in TypeScript.

Created by the Microsoft Open Source Programs Office (OSPO), part of the One Engineering System (1ES) team, we launched the site in August 2020, replacing an antiquated version. We expect that updates and contributions to the site will be made by Microsoft teams to feature new and interesting projects, update the curated blog posts, and improve program and ecosystem pages.

We do not currently have plans to add drastically different sections to the site or to be the "source of truth" for blog posts or other content. We're able to accept some coordinated contributions or suggestions, but request coordination in issues before embarking on new functionality, as the site has a set of requirements to meet such as being WCAG 2.1 accessible, and deploying to Microsoft's cloud.

The primary site navigation is:

  • Homepage overview
  • Get involved
  • Projects
  • Ecosystem
  • Our program

Other content includes:

  • Jobs (an external link)
  • Blog (an external link)
  • Code of Conduct text
  • Community Resources
  • a "thank you" page about the open source powering the project
  • OpenAtMicrosoft Twitter
  • This repository

Contributing

Code of Conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.

CLA

This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

Contribution scenarios

Thanks for your interest in contributing to the https://opensource.microsoft.com web site. Please make sure to communicate any contribution ideas as an issue before starting a pull request. We'd love to see how to best involve you.

We're happy that this site is open source (because a site about open source should be open source).

As a public-facing site hosted at microsoft.com, we may not be able to accept general contributions to this site, so your pull request may be closed and not merged, even if it's great, and we may not be able to provide complete context for any such decision.

Thanks for your understanding.

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party's policies.

Telemetry

By default, this project does not include telemetry; however, the GitHub Actions may generate the production version of the site without modification.

When the Jekyll build environment is set to Microsoft's production environment name - "opensource.microsoft.com" - Microsoft's standard cookie compliance and analytics code to connect with Application Insights is included in the site.

  • Data Collection. The software may collect information about you and your use of the software and send it to Microsoft. Microsoft may use this information to provide services and improve our products and services. You may turn off the telemetry as described in the repository. There are also some features in the software that may enable you and Microsoft to collect data from users of your applications. If you use these features, you must comply with applicable law, including providing appropriate notices to users of your applications together with a copy of Microsoft's privacy statement. Our privacy statement is located at https://go.microsoft.com/fwlink/?LinkID=824704. You can learn more about data collection and use in the help documentation and our privacy statement. Your use of the software operates as your consent to these practices.

Development

Developing with Codespaces

Run these commands in your Codespace:

bundle
npm install
bundle exec jekyll serve

Then the editor should direct you to go to the forwarded port to test.

Developing locally

Ensure you have a working copy of Ruby, Node.js and Gulp.

bundle
npm install
gulp
bundle exec jekyll serve

The Dockerfile is available to host a local nginx version of the static site, although dynamic site features are not available when running local, and Gulp is not currently run in the container.

GitHub Actions

This repo uses GitHub Actions for several purposes.

Build

The primary build from the main branch creates the static version of the site and stores it as an artifact. This is done using a Docker container specific to this build environment inc. Ruby Gems, Node packages, etc.

Pull requests

A separate staging can be configured to use a version of this site, if a maintainer of the project approves it, using a comment including the phrase /startContentBuild.

opensource.microsoft.com's People

Contributors

aaron-junker avatar abinashbunty avatar aevaonline avatar aisgbnok avatar arhell avatar bureado avatar capfei avatar cinnamon-msft avatar danielrosenwasser avatar dependabot[bot] avatar emmairwin avatar fossygirl avatar imhunterand avatar italypaleale avatar ivybarley avatar jamesiri avatar jeffwilcox avatar joemellin avatar jsquire avatar juharris avatar justingosses avatar koudaiii avatar microsoftopensource avatar mpcen avatar msftgits avatar muiriswoulfe avatar mxschmitt avatar out0xb2 avatar rimikab avatar travisongit avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

opensource.microsoft.com's Issues

A11y_OSPO Production_Projects_Contrast : The color contrast ratio for "CNAB", "Accessibility Insights" and "Windows Terminal" links is 3.45:1 which is less than 4.5:1

GitHub Tags:

#A11yTCS;#A11yMAS;#Win10;#DesktopWeb;#ChromiumEgde;#A11ySev2;#P2_WCP;#WCP;#P2_OSPOProduction_Web_Sep2021;#P2_OSPOProduction;#OSPO Production;#WCAG1.4.3;#Color Contrast;

Environment Details:

URL: https://opensource.microsoft.com/

OS and Browser Details:

Microsoft Windows 10 Enterprise Version 21H1 (OS build 19043.1165) Microsoft Edge Version 95.0.1000.0 (Official build) dev (64-bit)

Note:

This issue is also observed in below links in the "Open Source Updates" and the associated "Read post" links present there: 1. Microsoft joins Open Source Security Foundation 2. Helm, the package manager for Kubernetes, now a CNCF graduated project 3. Microsoft announces OpenChain 2.0 conformance for open source 4. exFAT in the Linux kernel? Yes!

Repro Steps:

1. Hit the URL:https://opensource.microsoft.com/ 2. Check whether the color contrast ratio for "CNAB", "Accessibility Insights" and "Windows Terminal" links is 3.45:1

Actual Result:

The color contrast ratio for "CNAB", "Accessibility Insights" and "Windows Terminal" links is 3.45:1 which is less than 4.5:1

Expected Result:

The color contrast ratio for "CNAB", "Accessibility Insights" and "Windows Terminal" links should be 4.5:1 or more than that.

User Impact:

Users with low vision may not be able to identify link if the color contrast ratio for "CNAB", "Accessibility Insights" and "Windows Terminal" links is less than 4.5:1.

Attachments for reference:

#121_Contrast_The color contrast ratio fails for CNAB, Accessibility Insights and Windows Terminal links

Note Section Attachment:

#121_Note Section

A11y_OSPO Production_Home Page_Page Titled: The title "Microsoft Open Source" is programmatically defined twice.

GitHub Tags:

#A11yTCS;#A11yUsable;#Win10;#DesktopWeb;#ChromiumEdge;#A11ySev4;#P2_WCP;#WCP;#P2_OSPOProduction_Web_Sep2021;#P2_OSPOProduction;#OSPO Production

Environment Details:

URL: https://opensource.microsoft.com/

OS and Browser Details:

Microsoft Windows 10 Enterprise Version 21H1 (OS build 19043.1165) Microsoft Edge Version 95.0.1000.0 (Official build) dev (64-bit)

Repro Steps:

  1. Hit the URL:https://opensource.microsoft.com/
  2. Check whether the title "Microsoft Open Source" is programmatically defined twice or not.

Actual Result:

The title "Microsoft Open Source" is programmatically defined twice.

Expected Result:

The title "Microsoft Open Source" should be programmatically defined once.

User Impact:

Users with disabilities will not know the purpose of the page if the title is programmatically defined twice.

Attachments for reference:

#119_Page Titled_The title Microsoft Open Source is programmatically defined twice

Search performance could be improved

There seem to be a few issues with our rather basic JS experience of pulling the query and showing results. An initial pre-load UI might be helpful, and I've seen a race condition where it shows the most popular repos but never the search contents.

Request Id: 885c0bfc-bace-481f-8ef4-50b0272d2500 Correlation Id: fcf8edee-4fee-45aa-a1f7-c7f779850cba Timestamp: 2021-07-08T23:04:25Z Message: AADSTS50020: User account '[email protected]' from identity provider 'live.com' does not exist in tenant 'Microsoft' and cannot access the application '0f8821e6-75e4-49a4-bff2-8ae72ad2ad58'(MSRC Web) in that tenant. The account needs to be added as an external user in the tenant first. Sign out and sign in again with a different Azure Active Directory user account.

"docker build" error

docker build . yields the following error:

Error response from daemon: Dockerfile parse error line 10: unknown instruction: ./NODE_MODULES/GULP/BIN/GULP.JS

It appears to be an error on this line

./node_modules/gulp/bin/gulp.js build

I tried the simple fix of prefixing this line with the RUN directive, which did not work, so I am unsure what the intent of the existing line is.

Current docker version: 19.03.8
OS: Ubuntu 20.04.1

A11y_OSPO Production_Top Navigation_High Contrast: In high contrast white, the "Microsoft" , "open source" in top navigation and the "search" icon is not visible

GitHub Tags:

#A11yTCS;#A11yMAS;#Win10;#DesktopWeb;#ChromiumEgde;#A11ySev2;#P2_WCP;#WCP;#P2_OSPOProduction_Web_Sep2021;#P2_OSPOProduction;#OSPO Production;#WCAG4.3.1;#HighContrast

Environment Details:

URL: https://opensource.microsoft.com/

OS and Browser Details:

Microsoft Windows 10 Enterprise Version 21H1 (OS build 19043.1165) Microsoft Edge Version 95.0.1000.0 (Official build) dev (64-bit)

Pre-Requisite:

To apply high contrast follow the below steps: 1. Open settings, tab till Ease of Access and press enter 2. Tab till high contrast under Vision and press enter 3. Turn on high contrast and select high contrast black/white from choose a theme combo box . 4. Select apply

Repro Steps:

1. Turn on High Contrast white. 2. Hit the URL:https://opensource.microsoft.com/ 3. Check whether the "Microsoft", "open source" in top navigation and the "search" icon is visible or not in high contrast white.

Actual Result:

In high contrast white, the "Microsoft" , "open source" in top navigation and the "search" icon is not visible

Expected Result:

In high contrast white, the "Microsoft", "open source" in top navigation and the "search" icon should be visible.

User Impact:

Users with low vision may not understand the content clearly if, the "Microsoft" ,"open source" in top navigation and the "search" icon is not properly visible in high contrast white.

Attachments for reference:

**Normal View:**

#118_Normal

High Contrast White Mode
#118_High Contrast_In high contrast white, the open source in top navigation and the search icon is not visible

Windows Photo Viewer

I really like the Windows Photo Viewer program.
Windows7defaultPhotoViewer

However, I already use Linux. And the Linux operating system has its own programs for viewing images. And some of them are very good!
But most of the programs to view images in Linux is not very user-friendly interface :-(
I believe that the Windows Photo Viewer program can be considered a sample of the classic interface!
I believe that this is exactly what a program for viewing images should look like!
I tried but never found the source code of this program on the site opensource.microsoft.com

Question: please tell me if Microsoft is planning to open the source code of the Windows Photo Viewer program in the near future?

My question may seem strange, so I'll explain a bit. Gradually, Microsoft opens the source code of its applications, for example, a Calculator... Why should Microsoft do this? Everything is simple, there have been free and open calculators for a long time. Thus, Microsoft did not lose anything by opening its source code.
Also, there have been good image viewing programs in Linux for a long time. Thus, it seems to me that Microsoft will not lose anything by opening the source code of the Windows Photo Viewer program. Moreover, if you open the source code of the Windows Photo Viewer program and make versions for Linux users, then the community will definitely find errors in the code and offer something new to improve the program. And hackers are not asleep. They are constantly publishing something from the source code.

Support project sort view

Sort by fields:

  • Awesomeness (need a better name for this... "Default" sounds boring)
  • Activity
  • Name

A11y_OSPO Production_Footer Section_Use of Color: The "Open Source" link present in the footer section is not provided with a underline.

GitHub Tags:

#A11yTCS;#A11yMAS;#Win10;#DesktopWeb;#A11ySev2;#P2_WCP;#WCP;#P2_OSPOProduction_Web_Sep2021;#P2_OSPOProduction;#OSPO Production;#WCAG1.4.1

Environment Details:

URL: https://opensource.microsoft.com/

OS and Browser Details:

Microsoft Windows 10 Enterprise Version 21H1 (OS build 19043.1165) Microsoft Edge Version 95.0.1000.0 (Official build) dev (64-bit)

Repro Steps:

  1. Hit the URL:https://opensource.microsoft.com/
  2. Check whether the "Open Source" link present in the footer section is provided with a underline or not.

Actual Result:

The "Open Source" link present in the footer section is not provided with a underline.

Expected Result:

The "Open Source" link present in the footer section should be provided with a underline.

User Impact:

Users with low vision may not be able to identify link for the "Open Source" link present in the footer section , if it is not provided with a underline.

Attachments for reference:

#120_Use of Color_The Open Source link present in the footer section is not provided with a underline

A11y_OSPO Production_Open Collaborative_Reflow: The "Collaborative" text is getting truncated when zoomed to 400%.

GitHub Tags:

#A11yTCS;#A11yMAS;#Win10;#DesktopWeb;#ChromiumEgde;#A11ySev1;#P2_WCP;#WCP;#P2_OSPOProduction_Web_Sep2021;#P2_OSPOProduction ;#WCAG1.4.10;#Reflow;#OSPO Production;

Environment Details:

URL: https://opensource.microsoft.com/

OS and Browser Details:

Microsoft Windows 10 Enterprise Version 21H1 (OS build 19043.1165) Microsoft Edge Version 95.0.1000.0 (Official build) dev (64-bit)

Repro Steps:

  1. Change the display resolution to 1280*1024 and zoom the page to 400%.
  2. Hit the URL:https://opensource.microsoft.com/
  3. Check whether the "Collaborative" text is getting truncated when zoomed to 400% or not.

Actual Result:

The "Collaborative" text is getting truncated when zoomed to 400%.

Expected Result:

The "Collaborative" text should not get truncated when zoomed to 400%.

User Impact:

Users with low vision may find it difficult to understand if data is truncated in 400% zoom.

Attachments for reference:

#124_Reflow_The Collaborative text is getting truncated when zoomed to 400%

Pagination

It would be great if you could add feature to filter based on categories like AI, ML, Data, IOT, Cloud, programming language etc. As a minimum, pagination to browse through all open source projects instead of searching in searchbox.

Microsoft Windows & ReactOS

On the site opensource.microsoft.com published open source projects from Microsoft.
Why don't you officially invite the ReactOS project to use them?
I think it will benefit both ReactOS and you. After all, if some original programs from Microsoft are added to ReactOS, then over time the user community will be able to find errors in them and offer new useful innovations to improve the operating system.

After all, every year more and more leaks of Microsoft Windows source code appear on the network.

PS: I should note that in my opinion, adding programs to ReactOS should not be a simple copy (Ctrl+C). After all, Microsoft programs have telemetry! I would have deleted it. It was deleted, not disabled by default. If it is disabled by default, it means that it can be enabled :-(
And telemetry (SEND_TELEMETRY) is present even in the calculator!

Is the backend api open source?

Is the backend that generates the activity feed(s) (e.g. /api/stream) for the Get Involved part of site open source? I tried to look for it, apologies if I missed it.

A11y_OSPO Production_Open Source Updates_Link Purpose: NVDA/Narrator announces the entire tile as a description of the links present under "Open Source" section.

GitHub Tags:

#A11yTCS;#A11yUsable;#Win10;#DesktopWeb;#ChromiumEgde;#A11ySev4;#P2_WCP;#WCP;#P2_OSPOProduction_Web_Sep2021;#P2_OSPOProduction;#OSPO Production;#NVDA;#Narrator;

Environment Details:

URL: https://opensource.microsoft.com/

OS and Browser Details:

Microsoft Windows 10 Enterprise Version 21H1 (OS build 19043.1165) Microsoft Edge Version 95.0.1000.0 (Official build) dev (64-bit)

Note:

This is a high impact usability bug and could have a big negative impact on the user’s experience.

Repro Steps:

1. Hit the URL:https://opensource.microsoft.com/ 2. Tab till the links present under "Open Source" section. 3. Check whether the entire tile is being read as a description of the links present under "Open Source" section or not.

Actual Result:

NVDA/Narrator announces the entire tile as a description of the links present under "Open Source" section.

Expected Result:

NVDA/Narrator should not announce the entire tile as a description of the links present under "Open Source" section.

User Impact:

Users with low vision may not understand the content clearly if, the entire tile is being read as a description of the links present under "Open Source" section.

Attachments for reference:

**Narrator Behaviour:**
123_Link.Purpose_Narrator.announces.the.entire.tile.as.a.description.of.the.links.present.under.Open.Source.section.mp4

NVDA Behaviour:
#123_Link Purpose_NVDA announces the entire tile as a description of the links present under Open Source section

Ecosystem Link Bugs (undefined and typo in external URLs)

Currently, if you click an issue from https://opensource.microsoft.com/ecosystem/, it goes to something like this:

https://github.com/org/repo/issue/276

there's a small typo there - it should be like this, with an s on issues:

https://github.com/org/repo/issues/276

Additionally, some entries like this one:

image

Go to a url with undefined in them:

https://github.com/undefined/stevenbrix/xamlx-winui/pull/2

Removing that undefined goes to the correct link.

The only thing I've noticed there is that these ones have an additional leading / where others that work do not.

Pull assets from CDN

This can wait until after soft-launch, but we also push the rendered Jekyll site to opensource.azureedge.net, and should pull all JS, CSS, etc. from there if possible.

Consider separating "good first issue" content from "help wanted"

The "help wanted" tag, which is much more common on newer projects now that GitHub
highlights the subset of issues asking for help, is also not great for first-time contributors
compared to "good first issue".

I need to experiment with separating out the set of activities to jump on as a result, perhaps
both in the same REST response.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.