docs: Improve autogenerate godoc

There were a bunch of packages that weren't well documented. With the
recent split up of the lang package, I figured it would be more helpful
for new contributors who want to learn the structure of the project.

test/comment_parser.go

@@ -15,6 +15,9 @@
 // You should have received a copy of the GNU General Public License
 // along with this program.  If not, see <http://www.gnu.org/licenses/>.
 
+// XXX: consider using the https://pkg.go.dev/go/doc parser instead and also
+// checking the other fields like the package doc string.
+
 package main
 
 import (