Revised method and property names, added some doc for header files

@nixta can you review the PR?