added some sample entities, swagger
minor doc fixes for dwagger