add allowed methods convenience shortcut
more test and doc updates