-
Notifications
You must be signed in to change notification settings - Fork 11
FAQ
Here we'll find a list of frequently asked questions. Please reach out in case you don't find the answer you are looking for here or on the other documentation pages. Feedback and new questions are welcome and appreciated!
Why this project was created?
The Web Dev Path is an open-source initiative created in 2020 to provide a comprehensive path for tech professionals to work in a team environment.
We help UI/UX designers, web developers, and project managers starting their careers in tech understand the dynamic of working remotely and communicating through Slack to manage, design, and develop web products. To do so, we are coding a platform in Next.js. The platform was designed by our UI/UX team by using Figma while following our design guidelines created by the team. The development team codes the features by following our development guidelines based on the best practices while learning version control.
To learn more about the project, please visit our website and GitHub repository. Feel free to reach out if you have questions!
Why does the project purpose to offer guidance on using version control in a team environment instead of just 1:1 mentorship?
Using GitHub by yourself is different than using that in a team environment.
When working in a team, it's expected you know how to clone a project repository, do your own local setup, and know the processes to submit your solution in a way that communicates your ideas clearly to the other members who will review your work. It's also expected you know how to review your colleague's work.
That expected skill is usually not covered in courses and, when the junior developer gets the chance to be part of a professional team, it is not uncommon for no one is available to teach that from scratch since seniors are busy folks. You can definitely learn how to code by yourself with focus and discipline, but you can only learn how to do it in a team if you are a team member, right?
Finally, when you learn how to use version control in a team professionally, you speed up your learning process since you then know how to communicate your struggles and solutions through a document your colleagues can understand. That document will live in the repository and it is searchable, which means that people will be able to research and pick your brain if necessary in the future.
What are we doing now and what are the project goals?
In 2022, we're finishing building our platform in Next.js by adding a blog so the Web Dev Path community can share their learning journey.
Next year, besides refactoring our codebase by implementing TypeScript and probably styled-components, we will design and code the portal where Nonprofit organizations are sharing the web projects they need help with. Our job will be to promote those projects while helping to match available tech professionals to those organizations' needs.
How to get started with the codebase and/or the project in general?
The first step is to read every single page of this wiki to understand if this experience is what you're looking for. Then, just reach out to our email telling us about your journey in the industry so far and how you think the project can help you. After that, you will be added to our Slack platform, where all the conversations happen on specific channels simulating a real company experience!
If you're a developer or a developer wannabe, you can also clone our repository locally to start familiarizing yourself with the codebase. Once on Slack, you'll be also added as a team member to our repository.
Don't worry if you don't understand everything at first. The plan is to make you comfortable with reading documentation, reviewing pull requests, and communicating with your team. Eventually, you will be confident enough to submit your solutions.
Why do I see a reCaptcha and a MailChimp error after cloning the repository locally?
The .env file means "environment" and it is a file where to add the secret variables that need to live on the server. Because they're very sensitive data, we have the MailChimp and reCaptcha credentials there, they're never committed to the repository. You will see that is being "ignored" on the .gitignore file.
Without adding those credentials, when running the project locally, you notice some MailChimp console errors and both MailChimp and reCaptcha don't work.
Once you're a project team member, please reach out to the project team lead on Slack to get those credentials.