-
Notifications
You must be signed in to change notification settings - Fork 221
How to Contribute
Thanks for considering contributing to aima-javascript! We are building visual explanations of the concepts, problems, and solutions described in AIMA. In the past we were building individual visualizations, but we are now (as of 2018) building visualizations integrated with explanations.
If you are interested in GSoC then read this guide. The guide for GSoC 2019 will be similar to GSoC 2018. Do not contribute code to the repository! AIMA-Javascript is not like other open source projects so our guidelines are different. Come ask questions on the gitter channel. Amit Patel (redblobgames) was the mentor for GSoC 2017. Sam Goto (samuelgoto) is the mentor for GSoC 2018 and 2019.
If you are not interested in Google Summer of Code, then here's how you can contribute:
- First, read and understand the code to get a feel for how the existing visualizations have been implemented. Read the Implementation guide. Use the existing technology (libraries, languages, frameworks) for the chapter you are working in instead of introducing new technology.
- Changes that are not visible to the end user (readers of AIMA) are typically not accepted, [for the same reason that Ruby on Rails and other projects do not accept these changes].
- Look at the issues and pick one to work on. Discuss your plan with a project member before beginning work.
- Small projects marked bug (due to the nature of this project, there many not be any listed)
- Small projects marked improvement
- Medium projects marked feature
- Large projects require a mentor, and are typically part of Google Summer of Code. See Division of work thread. If you would like to work on one of these outside of GSoC, please contact one of us.