updated docs, tested method declarations