Connor wool/update localization code documentation

[connor-wool]

Adds clarifying comments to code in the localization system. I had to go through and read a bunch of ROS documentation to figure out what's going on, and why certain things are included. Hopefully, by adding these comments, nobody has to do that ever again ;_;

---

This change is 

[connor-wool]

Obligatory #404: Pull Request Not Found

[skallaher]

In general, your comments are far too in depth. There is no need to document every individual line of code and how ROS calls work. You have documented this as if it were a ROS tutorial which is unnecessary.

---

Reviewed 4 of 4 files at r1.
Review status: all files reviewed at latest revision, 2 unresolved discussions, some commit checks failed.

---

src/localization/localization.cpp, line 9 at r1 (raw file):

{
    /* Initializes a new ROS node for the current process, and gives it the 
    name "localization". This name must be unique across the whole ROS system */

This kind of documentation is unnecessary. Tutorial-like documentation on ROS is better suited in examples so that these files are not bloated. Assume that anyone reading this has a basic understanding of ROS. For many of the following comments, simply note what each section of code is doing, not exactly how it works.

---

src/localization/localization.cpp, line 37 at r1 (raw file):

    RobosubSensors is designed to handle and sanitize input from outside topics,
    and the LocalizationSystem class manages the particle filter and kalman
    filter classes */

You are defining what a C++ constructor is here. This is better worded as:

Initialize our sensors and localization systems for the Kalman and particle filter.

Be brief with comments in source files. You can elaborate further if absolutely necessary on the wiki.

---

Comments from Reviewable