minor fix
extract method and use each_with_object
extracting more objects
extract a category heading parser
kill the docs class, move it all into Category