Skip to content

Latest commit

 

History

History
80 lines (49 loc) · 3.97 KB

README.md

File metadata and controls

80 lines (49 loc) · 3.97 KB

freeCodeCamp.org Social Banner

Developer News

Welcome to freeCodeCamp's Developer News codebase — A JAMStack app built with Hashnode, 11ty, and lots of love from the community. We use this project to build and deploy multiple instances of our publications in several world languages. All of the services are then distributed globally by our CDN.

Contributing

We limit contributions to this specific repository because of the complexities of our deployment and QA processes. We welcome you to work on any of our other open-source projects. You can find our contributing guidelines here.

If you have found an issue or a bug in this repository, please connect with us in the contributor's chat room first.

Happy Contributing!

Builds and Deployments

Build

We use GHA to build the news sites. Workflows are in the .github/workflows directory.

Build Schedules

New builds to the /news sites are triggered according to the schedule below:

Language Schedule (UTC)
English Every 3 Hours - except between UTC 00:00 - UTC 06:00 on Wed & Sat for maintenance
Others(i18n) Every 6 Hours - except between UTC 00:00 - UTC 06:00 on Wed & Sat for maintenance

Important

Once a build is triggered, it can take up to an hour to complete and cascade to all regions in the world.

Deployment

We deploy the news sites on a private Docker Swarm cluster.

Deployment Status

You can click on the badges below to go to the dashboards detailing the status of the latest deployments. If you see something is not right, wait for a few hours. Our team is usually on top of these with automated alerts.

Language Status (Click to see details)
English Deployment status 👈 Yes – you can click these things!
Others(i18n) Deployment status

Frequently Asked Questions

Where can I check the status of the latest build?

You can check the status of the latest builds by clicking the Deployment Status badge in the previous section.

I published an article. Why hasn't it appeared on the news site yet?

Your published article and changes may take longer than usual to appear. We have multiple layers of caching, which helps us serve content faster to our users.

When you publish a change in CMS (such as updating scripts, adding a new article, updating old articles, or adding/updating pages), it will eventually appear on the public-facing site.

Sometimes, it can take up to an hour after the build is completed for the changes to appear on the site.

I see a build has failed. What should I do?

We recommend waiting at least a day before reaching out to someone to investigate. We have recovery workflows in place to fix most issues automatically.

Additionally, the team receives alerts for all build failures. There's no need for you to alert them again - unless it's been more than a day since the build failed.

Copyright & License

Copyright (c) 2021 freeCodeCamp.org - Released under the BSD 3 license.