New Contributors Guide C Code

C++ Contributions

CDDA is written almost entirely in C++. New contributions that change the C++ files are as welcome as changes to the JSON files, but they are more complicated and its harder to provide guidance.

What is C++ ?

So first off, this is not a guide to learning programming in general or C++ programming in particular. I am a professional programmer with a decade of formal education and a quarter century of paid experience and I don't know what to tell you about learning how to program. If you need an answer to what C++ is, please go back to the front of the guide and learn about contributing in JSON, or do some searches on google.

Contributing with C++

Assuming you know how to program a little, and have some vague understanding of C++, you can contribute to CDDA. You'll need to set up a github account and you should know some git basics if you don't already.

There is a guide to compiling that is fairly decent. Beyond that, the process is basically the same:

1. Fork and clone repo and checkout a working branch.
2. Write code.
3. Test your code.
4. Make a PR.
5. Respond to reviews.

The CDDA codebase is fairly large. There is a rough overview of the code structure but the codebase is very large and constantly changing, so the overview is approximate and possibly outdated. I probably can't answer your question about how any specific part of it works. Use git grep, find something that looks like it might be suitable, and read out from there. Header files are usually (but not always) well-documented.

C++ contributions usually get more scrutiny that JSON contributions. Be prepared to make changes to your code or defend your design. People are still friendly and will try to help, but requiring good code is the only way to maintain a project the size of CDDA.