first working draft of swagger documentation