Skip to content

Latest commit

 

History

History
162 lines (110 loc) · 7.1 KB

freecodecamp_evaluation.md

File metadata and controls

162 lines (110 loc) · 7.1 KB

Project Name: FreeCodeCamp


Evaluating Person or Team: Denice, Chris, Jared


License

What is the project's license? In most repositories there will be a file named LICENSE or something similar in the root level of the repository. This is the one to examine. There may be different licenses on specific files, but the project will have a main license.

  • FreeCodeCamp uses the BSD 3-Clause license, and their learning resources in the /curriculum directory uses the CC-BY-SA-4.0.


Code Base

What is the primary programming language in the project?

  • It is 91.8% built from Javascript. Other codes used are CSS, HTML, Shell, and R.

What is the development environment? For example, is it Gnu C++ on Linux?

Are there instructions for how to download, build, and install?

  • It's coded mostly in Javascript. The Readme has an organized structure, containing tabs for their topics and includes all the courses and certifications provided by the actual websites. The website also has a Youtube channel that can futher help new developers. Besides their Readme document, their forums are also helpful with the maintainers active in assisting new developers.

Does the project depend on external additional software modules such as database, graphics, web development, or other libraries?

  • It does not depend on an external additional software modules. It only provides a repository to modify the website and its library of lessons.

Is the code easy to understand? Browse some source code files and make

a judgment based on your random sample.

  • The code is designed to be interactive due to most of the content on this site being tutorials that require interactivity via typing and/or links.

Is this a big project? If you can, find out about how many lines of code

are in it, perhaps on OpenHub.

  • This project is relatively small in comparison to other larger projects such as Visual Studio Code or GIMP. FreeCodeCamp has a total of 36,000 lines of code (according to OpenHub).

Does the repository have tests?

  • As far as we can see, this specific repository does not have consist of any tests. However, there is another repository within the same account that consists of only testable projects.


Code and Design Documentation

Is there clear documentation in the code itself?

  • No, the documentation is fairly clear. If it were a beginner viewing this repository for the first time, they would most likely have trouble understanding what everything does. But to be fair, the codes that do include comments are somewhat helpful to guide the user.

Is there documentation about the design?

  • Yes, there is a handful of code and documentation regarding the design. Although, it is not clear what some of the code is exactly designing.


Activity Level

How many commits have been made in the past week?

  • At least 18 commits have been made in the past week.

When was the most recent commit?

  • The most recent commit was an hour ago today on Feb 24 2020, at around an hour before 10:38AM.

How many issues are currently open?

  • There are about 161 open issues. But the closed issues are around 14,000.

How long do issues stay open? Take the five most recently closed issues and look at when each was first reported. Compute the number of days that each was open and take the average.

  • They don't seem to be open for more than one day. The shortest open issue lasted for one hour.

Is there active discussion on the issues? Read the conversations from some open and some closed issues.

  • There is active discussions on the issues. Not only are they posted on the forums, they also have an issues tab for discussions. Usually the maintainers are the ones holding the discussions via questions and answers.

Are issues tagged as easy, hard, for beginners, etc.?

  • For the beginners, they are tagged as first timers and they are easy to find. The issues tagged as easy also have the maintainers active in them, giving clear solutions.

How many issues were closed in the past six months?

  • Roughly 375-425 issues were closed in last six months.

Is there information about how many people are maintaining the project?

  • In their repository, at least 65 people are maintaining the project.

How many contributors has the project had in the past six months?

  • At least 45 contributors.

How many open pull requests are there?

  • There are currently around 100 open pull requests.

Do pull requests remain un-answered for a long time?

Look at the closed pull requests to see how long they stayed open. Take the five most recently closed ones and look at when each was first reported. Compute the number of days that each was open and take the average.

  • Usually the pull requests are fulfilled on the same day they are requested.

Is there active discussion on the pull requests?

Use the same method as you did for the issues.

  • Depending on the issues, there are active discussions that have 8 replies as part of the comment thread. However, some of the requests don't have discussions and the only reply is by a bot that links to a review in Gitpod.

How many pull requests were opened within the past six months?

  • 101 pull requests.

When was the last pull request merged?

  • The last pull request merged at 2:26 PM on Feb 26, 2020.


Welcomeness and Community

Is there a CONTRIBUTING document? If so, how easy to read and understand is it?

Look through it and see if it is clear and thorough.

  • It is easy to read, and also guides you in how you can contribute to the projects, while showcasing Q&As for contribution.

Is there a CODE OF CONDUCT document? Does it have consequences for acts that

violate it?

  • No trolling, no spamming or taking away from the discussions. Violations of code of conduct will result in a ban.

Do the maintainers respond helpfully to questions in issues? Are responses generally constructive? Read the issue conversations.

  • The maintainers respond helpfully by explaining clearly the solution and also showing screenshots of the solution's code. They also answer quickly, from 30 minutes - 1 hour.

Are people friendly in the issues, discussion forum, and chat?

  • It's an overall friendly environment. There are informal talk in the userbase but the maintainers are very friendly and are always willing to help.

Do maintainers thank people for their contributions?

  • Yes! Maintainers thank users for their contributions and will also congratulate them if it was their first time contributing.


Summary

Do you think this is a project to which it would be possible to contribute in the course of a semester?

  • Absolutely – FreeCodeCamp is an interesting project and has a lot to offer. Yes, while the documentation may not be very clear and is a little difficult to understand, it is something that can be easily fixed. The concept is great, and we can agree that it is a great tool to educate those who want to learn how to code, free of cost.