Documenting a couple of methods

Hey everyone!

I was looking for an issue to tackle and noticed #620.
What do you think, would this be ok? Should I take a couple more methods?