Skip to content

Latest commit

 

History

History
201 lines (91 loc) · 8.25 KB

p5.js_evaluation.md

File metadata and controls

201 lines (91 loc) · 8.25 KB

Project Evaluation Activity

Project Name: p5.js


Finding info about contributing on the website.

In the following section you should only enter the information that you found on the project website. Some of the answers will be impossible to find, others may be very hard to find. Do not google for answers.

Project website: Website

What is the purpose of the project: Creative coding library to make coding accessible and inclusive for artists, designers, educators, beginners, and anyone else.

How easy was it to find information about contributing on the website? It was very easy. There is a "Get Involved" section on the home page and a "Contribute" link on the sidebar nav.

Contributing instructions: Here

URL for the code repository: Code repository

Bug/Issue tracker link: Bug/Issue tracker

Mailing list: Mailing list

Chat channel: Discord

Other communication channels: Forum


Finding info at the project repository and bug/issue tracker.

License: GNU Lesser General Public License v2.1

Is it OSI approved license: Yes

Programming Language(s): JavaScript (75.7%)

URL for contributing instructions: Contributing instructions

Are the contributing instructions clear? Yes, they are pretty clear. The instructions break down contributing into smaller, easier-to-follow steps.

URL for code of conduct / community norms / community guildelines: Community Guidelines

URL for instructions for users to download and install the package: here

Are these instructions clear? Do you think they would be easy to follow? I think the instructions are pretty clear. There is an online editor that allows users to start coding with p5.js with no setup/installation. There is also the option to download the complete library or single files to use p5.js locally. There is a link to the "Get Started" page with instructions on setting up a p5.js project.

URL for instructions for how to install development environment: here

Are these instruction clear? Do you think they would be easy to follow? Yes, the instructions are clear and easy to follow as they are comprehensive with helpful commands and images. There is also a "Quick Get Started For Developers" section for more experienced developers who may want short step-by-step instructions.

Number of contributors: 579 contributors

Usernames of three contributors with largest number of commits; for each of them list the link to their latest commit:

  1. lmccart (951 commits) - Their Latest Commit
  2. outofambit (436 commits) - Their Latest Commit
  3. Spongman (413 commits) - Their Latest Commit

Number of commits: 12,150 commits

Latest commit

  • link to the commit: Latest commit

  • who made that commit: davepagurek

  • what type of work was commited? merging pull request

Issues

  • how many open issues are there: 252 Open Issues

    • url for the last issue created: Last issue created

    • how many users discuss the issue: 3 people

    • when was the issue reported: 5 days ago

  • how many closed issues are there: 3,486 closed issues

    • url for the last issue closed: Last issue closed
    • how many users discussed the issue: 4 people
    • when was the issue reported: 2/11/2024
    • when was the issue closed: 2/20/2024
  • how active is the discussion on the issues: Generally very active. Most issues have at least a few comments

  • are there issues marked "good for newbies", "beginner" or some other indicators that imply that they are good for beginner contributors: Yes (Good First Issue)

    • how many of such issues are there? 2 open issues, 37 closed issues

    • look at a few of them, do they look beginner friendly? Yes, most issues related to documentation/minor bugs

  • are there issues marked "documentation" or some other indicators that imply that they are documentation (user or developer specific): Yes

    • how many of such issues are there? 8 open issues, 132 closed issues

    • look at a few of them, do you think you could submit a fix? Yes, a lot of the issues seem relatively easy to resolve (writing style not aligning with style guide, grammatical errors, etc.)

Pull requests

  • how many open pull requests are there: 42 pull requests

  • how many closed pull requests are there: 2916 closed pull requests

    • url for the last pull request closed: Last Pull Request closed

    • how many users discussed the pull request: 1 user

    • when was the pull request made: 2/21/2024

    • when was the pull request closed: 2/26/2024

  • do maintainers respond quickly to pull requests when they are opened? Maintainers usually respond pretty quick

Development Environment

Attempt to configure the development environment for this project:

Name: Jenna

Operating system: MacOS

Was the installation successful? (if not, explain what went wrong and what you did to try to remedy it) Yes

How long did the whole process take? A few minutes


Summary assesment

How friendly is this project for beginner contributors? I think the project is pretty friendly for beginner contributors. As the project has a focus on making coding accessible, the contribution guidelines are very comprehensive and easy to follow for both beginners and more experienced developers. The community seems very friendly and welcoming.

Do the maintainers respond helpfully to questions in issues? Yes, they often provide detailed advice and feedback.

Are people friendly in the issues, discussion forum, and chat (for example, IRC or Slack)? Yes, everyone seems very friendly.

Do pull requests get reviewed? Pull requests get reviewed pretty quickly.

Do maintainers thank people for their contributions? Maintainers frequently thank people for their contributions, especially if the contribution was complex or required discussions.

Are there special skills required to contribute to the project? If so, what are they? Experience with p5.js and JavaScript is helpful for solving a lot of the issues, but users can contribute thoughts and documentation even if they don't have technical skills.

Are there any special hardware/software requirements to be able to contribute to the project? If so, what are they? Git, Node.js, and local development environment are needed to contribute to the codebase.