I'd like to start expanding on the javadocs, initially starting based on the information in the user guide and adding more where I can, is the best way to do this by posting here or should I request write access to the repo and just commit stuff directly?

As an example, here's a suggested file for the shapes package:

// Copyright

it would be best if you request write access, post the changes here so others can verify it and give some input, if needed and then commit them yourself.

OK, will do.