🙏 Please do not spam contributions with Cody or other generative AI, as it burdens maintainers.

It's time to get excited for Hacktoberfest 2023! This year, Cody can help you make contributions to the open source community.

With Cody, you can make high-quality contributions to open source projects more efficiently and effectively. For example, you can use Cody to:

• Document code: Cody can generate documentation comments for the code you have selected.
• Explain code: Cody can generate clear and concise documentation for code.
• Generate unit tests: Cody can generate unit tests for your code, which can help you ensure that the project’s code is working as expected.
• And much more: Code autocomplete, code smells, custom commands, and other features to help you be more productive.

Before starting with contributions to a project, it is important to learn what the project does. The Cody Web App and supported IDE extensions (VS Code, JetBrains, Neovim) allow you to ask questions about specific repositories. For example, you can choose Hugging Face’s Transformers repo and ask what it does, what the tech stack is, who the contributors are, etc.

Documentation

For comments

To generate documentation comments for your code, select the code you want to document and then run the /doc command. Cody will generate documentation comments in the appropriate format for your programming language.

Example:

function greet(name) {
  return `Hello, ${name}!`;
}

Doc output:

Hugging Face is having a Doc Tests Sprint. Use Cody to create some docstring examples!

For docs

To generate code explanations for documentation, select the code you want to explain and then run the /explain command. Cody will generate an explanation in plain language format that is easy to understand.

Example:

function celsiusToFahrenheit(celsius) {
    return celsius * 9 / 5 + 32;
  }

Explain output:

“So in simple terms, it takes a Celsius temperature, converts it to Fahrenheit using the standard formula, and returns the Fahrenheit temperature. This allows the caller to easily convert between temperature scales.”

WireMock is looking for documentation clean-up and gaps. Help them!

Generate Unit Tests

To generate unit tests with Cody, select the code you want to test and then run the /test command. Cody will generate unit tests in the appropriate format for your programming language.

Example:

Using the same code above, Cody was able to generate a unit test for the celsiusToFahrenheit function.

Test output:

Apache StreamPipes is looking to implement unit tests. Give it a try with the /test command!

Respect the maintainers

Please ensure you don’t overwhelm maintainers with pull requests they aren’t looking for. If they have an issue that Cody can help you help them with, go for it!

Conclusion

Hacktoberfest is a great way to contribute to open source and learn new things. But it can also be scary, especially if you're new to open source. Cody AI can help you make awesome Hacktoberfest contributions by unblocking you when you’re jumping into new projects, trying to understand legacy code, or taking on tricky problems.

Don't forget to have fun! Hacktoberfest is a great opportunity to learn and connect with other developers from around the world. Here are some projects looking for help:

• Hugging Face is having a Doc Tests Sprint. Use Cody to create some docstring examples!
• WireMock is looking for documentation clean-up and gaps. Help them!
• Apache StreamPipes is looking to implement unit tests. Give it a try with the /test command!

P.S. Join our Discord community to get help from Cody experts and learn more about how to use Cody AI to make awesome Hacktoberfest contributions.

P.S.S. If you get something merged, let us know in #hacktoberfest-2023 so we can hook you up with some swag!

🎃