Code documentation. Am I doing the right thing?

Question

API

Hello. Near the router path I make a command with a detailed description.
There are two questions.
Is it worth it to do so?
Am I documenting clearly?

/*
              отвечает за добавление нового человека в базу
              Принимает
                user/reg.Auth/{
                  "login" : "%login%",
                      "email" : "%email%",
                  "pass"  : "%pass%"
                }
                %login% - логин добавляемого человека.
                %email% - email человека
                %pass%  - password человека

                  Возвращает
                      {
                          "operation"          : "true//false",
                          "operation_messages" : "%description%"
                      }
                      operation  -> true  - операция выполнена успешно
                                 -> false - произошла ошибка
                        operation_messages -> operation  -> true  -> "Ok"
                                           -> operation  -> false -> "Error description"

  */
  router.GET("/reg.Auth/:json", auth.Create)

Answer 1

I don't like documented code. If the code is written well and the person who reads it is not stupid, everything is clear.
Yes, and somehow the documented code does not look nice, I really don’t like it)
Although this is my personal opinion.