Dear freeCodeCamp Team,
First, I would like to appreciate the effort the team has put into developing the Relational Database curriculum and providing practical projects for learners. The curriculum is genuinely useful, and I understand that maintaining and continuously updating a learning platform of this scale requires considerable effort.
However, I would like to bring a recurring issue to your attention that has been affecting my learning experience and, from what I have observed in the community, seems to be affecting other learners as well.
1. Recurring issues with GitHub Codespaces
I have been facing repeated issues while trying to access and work on the projects in the Relational Database curriculum. Whenever I click on “Start Course”, the page gets stuck on a blank screen displaying the message “Setting up your Codespace” and does not proceed any further. I have been experiencing this for the past few days, and despite multiple attempts, I have not been able to access the working environment.
I am not sure whether this is an issue with the third-party Codespaces service or an integration-related issue on the freeCodeCamp platform. However, regardless of where the problem originates, it is preventing learners from progressing through the curriculum.
2. The offline setup guide is not sufficiently beginner-friendly
I understand that freeCodeCamp has also provided an offline setup guide as an alternative for learners who are unable to use Codespaces. I appreciate that effort. However, the current instructions are not sufficiently clear for someone who is new to relational databases and does not necessarily come from a technical background.
While following the offline setup instructions, I encountered difficulties at the project implementation stage itself. I was unable to proceed to the next step of the project because some of the instructions were either too technical or lacked the necessary explanation.
My suggestion would be to revisit the offline documentation and simplify the process by providing:
-
Clear, step-by-step installation and configuration instructions.
-
Explanations of technical terms wherever necessary.
-
Screenshots or visual references at important stages.
-
Instructions on how to execute the project, verify the output and proceed to the next step.
-
Common errors learners might encounter and how to resolve them.
The idea should be to make the guide accessible even to someone who is setting up a relational database development environment for the first time.
3. Request for a long-term solution
What concerns me the most is that this does not appear to be an isolated incident. Similar issues have been flagged by multiple learners, yet the problem seems to keep recurring.
I understand that the curriculum is being updated and improvements are being made. However, I believe that the learning environment and supporting infrastructure are equally important. A well-designed curriculum cannot deliver its intended value if learners are repeatedly prevented from accessing the tools required to complete the projects.
I would therefore request the team to look into the following:
-
Identify the underlying reason for the recurring Codespaces setup issue.
-
Provide a stable and reliable alternative if Codespaces continues to experience downtime.
-
Review and improve the existing offline setup documentation.
-
Provide an update on whether this issue is being actively investigated and what steps are being taken to prevent it from recurring.
I am raising this concern not to criticise the team’s efforts, but because I genuinely value what freeCodeCamp offers to learners across the world.
FreeCodeCamp has built a strong reputation by making technical education accessible to people from different backgrounds. Thousands of learners depend on this platform to develop their skills, work on projects and move forward in their careers. Taking recurring user feedback seriously and addressing the underlying problems will only strengthen the trust that learners have in the platform.
I kindly request the team to look into this issue at the earliest and, more importantly, work towards a sustainable solution rather than a temporary workaround.
Thank you for your time and for the effort you continue to put into making technical education accessible to everyone.
