Document the functions in a single non-route server file
- Aim: completely document all of the functions within a single file using JSDoc syntax
- Estimated Time: 3 hours
Documentation is an important part of Open Source projects, allowing new collaborators to contribute to a project, and helping old collaborators remember what they wrote and why they wrote it. Unfortunately, the main developers haven't had enough time to prioritize documenting BookBrainz, and this is discourages new developers, so it's important that we get this sorted out.
For this task, familiarize yourself with JSDoc: http://usejsdoc.org/about-getting-started.html
Then, pick a file at random from the ./src/server directory of the bookbrainz-site repository, or any of its sub-directories excluding the routes directory. Then, edit it to add JSDoc comments to every function you can see. The comments should provide some context - describe what each function does, how it fits in with the rest of the program, its parameters and any return value.