updated generic REST method descriptions
information about the OPTIONS method
updated info about POST and PUT