Migrate to new swagger docs generation (#18)

pkg/routes/api/v1/user_show.go

@@ -8,22 +8,17 @@ import (
 )
 
 // UserShow gets all informations about the current user
+// @Summary Get user information
+// @Description Returns the current user object.
+// @tags user
+// @Accept json
+// @Produce json
+// @Security ApiKeyAuth
+// @Success 200 {object} models.User
+// @Failure 404 {object} models.HTTPError "User does not exist."
+// @Failure 500 {object} models.Message "Internal server error."
+// @Router /user [get]
 func UserShow(c echo.Context) error {
-	// swagger:operation GET /user user showUser
-	// ---
-	// summary: Shows the current user
-	// consumes:
-	// - application/json
-	// produces:
-	// - application/json
-	// responses:
-	//   "200":
-	//     "$ref": "#/responses/User"
-	//   "400":
-	//     "$ref": "#/responses/Message"
-	//   "500":
-	//     "$ref": "#/responses/Message"
-
 	userInfos, err := models.GetCurrentUser(c)
 	if err != nil {
 		return echo.NewHTTPError(http.StatusInternalServerError, "Error getting current user.")