This is the main landing page for Open Source at Comcast. It highlights our efforts in the Free/Libre and Open Source Software movement.
Comcast.github.io is licensed under Apache License 2.0. Valid-License-Identifier: Apache-2.0
We take our code of conduct very seriously. Please abide by it.
Please read our contributing guide for details on how to contribute to our project.
This repository is a codebase built using React. Static pages are built for deployment using Next.js. Data is fetched from GitHub using the GraphQL on the GitHub GraphQL API . Node, NPM, and Webpack.
To separate concerns the components are in src/components, pages and layout files are contained in src/pages, and the content of the pages may be updated using the files in the src/data. This allows the content to be updated without needing to update the unit tests. Assets are contained in public as is standard practice for Next.js. Additional functions are in src/shared.
The code is linted during the pre-commit hook, and both linted and tested during the pre-push hook. Target code coverage for unit tests is 80%. Unit tests are written using Jest.
Submitted code should adhere to Web Content Accessibility Guidelines (WCAG).
Automated accessibility testing is built into the workflow:
eslint-plugin-jsx-a11yprovides code-level accessibility checking.react-axeprovides non-prod accessibility testing in the console.jest-axeprovides the ability to write unit tests for accessibility.
Manual testing should include, at the minimum, testing for keyboard operability, and reviewing the site using NVDA screen reader with the FireFox browser.
After the codebase has been cloned and npm install has been run, npm run dev will create a webserver on the specified port for local development.
npm run build generates the distribution files and exports them into the docs directory. It also creates a .nojekyll file to bypass Jekyll processing in Github Pages.
npm run deploy
- runs the
npm run buildcommand (above) - adds the newly created files to git staging
- creates a commit
- pushes those changes to the main branch
The content of the pages may be updated using the files in the src/data directory or by updating the assets that are contained in the public directory. Full documentation for the pages, components, assets, and data sources can be found in the Wiki.