Document public method parameters

Note that I haven't added `@return` tags for the constructor methods as
I don't think it's necessary. `#run` does not return anything that would
be worth documenting.