AUTO-442: locking retry in modify_state

Trying to lock again after some time if lock was not acquired while modifying state
trying more granular waiting
Added content related to using Autoscale api
lock waiting time is random

If and when multiple server execution try to update the state at same time, the lock is not acquired
since all wait for same amount of time. So, randomizing the wait time
lint fix
added test
Added new content and new code samples
adding new codes samples
separate test for basiclock args and different retry
WADL changes from the autoApiary generation.
remove all in line code examples
Added titles
Updated apiref
Added common.ent
Added a ton of samples, updated apiary and wadl
Added more samples.
Merge branch 'master' into auto-442-modify-state-locking
allowing tests blocked on AUTO-442
Incorporating comments, changes to WADL
scheduler test changes

- at time sent while creating policy is 1 second after current time
- removed lock comment