api: remove useless comments

- We do return samples with their id.
- This header is not complete nor true, and does not serve anything
  nowadays.

Change-Id: I4b797887fb9ae63b10d67e9b22a5b4d30d7bd829
update alarm service setup in dev doc

development doc references service as ceilometer-alarm-singleton.
fix to use ceilometer-alarm-evaluator

Change-Id: I171a06e2fcd1596536d31b84ac1d854fd654ff28
api: allow alarm creation for others project by admins

Change-Id: I8da7e81da799b5cbd6b1ce158ac10e12567aa3d7
Fixes-Bug: #1226470
Updated from global requirements

Change-Id: Ic29edceca62daf7bfa6262df86e0c642e5b59fa0
Merge "api: allow alarm creation for others project by admins"
Merge "update alarm service setup in dev doc"
Merge "Updated from global requirements"
Merge "api: remove useless comments"