updated docs, added more details and added property object api reference.