updated swagger descriptions for methods and moved forward with the
databases views