Перевели редактирование вакансии в OpenAPI

docs/employer_vacancies.md

@@ -38,121 +38,7 @@
 <a name="edit"></a>
 ## Редактирование вакансий
 
-`PUT /vacancies/{vacancy_id}`
-
-* `ignore_duplicates=true` - игнорировать
-  [появление дубликата](#edit-ignore-duplicates), после редактирования вакансии.
-
-Редактирование происходит по аналогии с созданием вакансии, но есть возможность
-передачи отдельных полей в объекте для частичного редактирования вакансии.
-Cоставные поля (например, `salary`, `contacts`, `professional_roles`) можно
-редактировать только целиком, передавая полный объект. Например, для изменения
-валюты в зарплате, необходимо передавать также и значения зарплаты, а
-для изменения специализации необходимо передать полный список.
-
-### Поля, доступные для редактирования
-
-Имя | Описание
------|----------
-name | название
-description | описание
-key_skills | ключевые навыки
-schedule | график работы
-experience | требуемый опыт работы
-employment | тип занятости
-professional_roles | список профессиональных ролей
-salary | зарплата
-address | адрес
-test | тестовое задание
-department | департамент
-code | внутренний код вакансии
-response_letter_required | необходимость сопроводительного письма при отклике
-accept_handicapped | указание, что вакансия доступна для соискателей с инвалидностью
-accept_kids | указание, что вакансия доступна для соискателей от 14 лет
-response_notifications | настройка уведомления о новых откликах
-allow_messages | возможность переписки с кандидатами по данной вакансии
-contacts | контактная информация
-custom_employer_name | название компании для анонимных вакансий
-response_url | URL отклика для прямых вакансий
-accept_incomplete_resumes | разрешен ли отклик на вакансию неполным резюме
-working_days | рабочие дни
-working_time_intervals | временные интервалы работы
-working_time_modes | режимы времени работы
-accept_temporary | указание, что вакансия доступна для соискателей с временным трудоустройством
-branded_template.id | <a name="branded-template-field"></a> брендированное оформление вакансии из [справочника](https://api.hh.ru/openapi/redoc#tag/Informaciya-o-rabotodatele/operation/get-vacancy-branded-templates-list)
-languages | список языков
-driver_license_types | категория водительских прав. Элемент справочника [driver_license_types](https://api.hh.ru/openapi/redoc#tag/Obshie-spravochniki/operation/get-dictionaries)
-video_vacancy | данные по видеовакансии, включающие ссылку для скачивания видео
-
-Остальные поля доступны только для чтения, либо их можно задать только при создании вакансии.
-
-### Ответ
-
-При успешном обновлении вакансии вернется `204 No Content`.
-
-### Ошибки
-
-* `404 Not Found` – редактируемая вакансия не найдена.
-* `403 Forbidden` – редактирование вакансий недоступно данному пользователю.
-* `400 Bad Request` – ошибки в полях при редактировании вакансии.
-* <a name="edit-ignore-duplicates"></a> `403 Forbidden` –
-  изменение вакансии невозможно, так как после изменения, вакансия становится
-  похожа на другую вакансию у данного работодателя. Если вы уверены, что
-  появление дубликата необходимо, вы можете добавить к запросу параметр
-  `PUT /vacancies/{vacancy_id}?ignore_duplicates=true`.
-
-Дополнительно к HTTP коду сервер может вернуть описание
-[причины ошибки](errors.md#vacancies-create-n-edit).
-
-<a name="edit_more"></a>
-### Смена биллинг-типа, менеджера вакансии
-
-Возможно только улучшение типа вакансии.
-
-Изменение биллингового типа вакансии, а также передача вакансии другому
-менеджеру компании происходит по аналогии с редактированием
-`PUT /vacancies/{vacancy_id}`. Единственная особенность — эти поля
-(`billing_type` и `manager`) необходимо отправлять отдельно от остальных полей
-вакансии.
-
-```
-PUT /vacancies/{vacancy_id}
-```
-
-```json
-{
-    "billing_type": {
-        "id": "premium"
-    }
-}
-```
-
-и
-
-```
-PUT /vacancies/{vacancy_id}
-```
-
-```json
-{
-    "manager": {
-        "id": "1337"
-    }
-}
-```
-
-### Ответ
-
-При успешном обновлении биллинг-типа, менеджера вакансии вернется `204 No Content`.
-
-### Ошибки
-
-* `404 Not Found` – редактируемая вакансия не найдена.
-* `403 Forbidden` – редактирование вакансий недоступно данному пользователю.
-* `403 Forbidden` – поля `billing_type` и `manager` передаются вместе с другими.
-
-Дополнительно к HTTP коду сервер может вернуть описание [причины ошибки](errors.md#vacancies-create-n-edit).
-
+> !! Данный метод доступен в [OpenAPI](https://api.hh.ru/openapi/redoc#tag/Upravlenie-vakansiyami/operation/edit-vacancy)
 
 <a name="other-actions"></a>
 ### Прочие действия

docs/errors.md

@@ -292,7 +292,7 @@ HTTP code | type | value | reason | описание
 403 | vacancies | duplicate | | аналогичная вакансия уже опубликована. В [ответе](#vacancies-duplicate-response) передается информация по дубликатам вакансии. Данную ошибку можно форсировано отключить (при [добавлении](employer_vacancies.md#creation) и [редактировании](employer_vacancies.md#edit-ignore-duplicates))
 403 | vacancies | creation_forbidden | | публикация вакансий недоступна текущему менеджеру
 403 | vacancies | unavailable_for_archived | | редактирование недоступно для архивной вакансии
-403 | vacancies | conflict_changes | | конфликтные изменения данных вакансии ([подробнее](employer_vacancies.md#edit_more))
+403 | vacancies | conflict_changes | | конфликтные изменения данных вакансии ([подробнее](https://api.hh.ru/openapi/redoc#tag/Upravlenie-vakansiyami/operation/edit-vacancy))
 
 #### Причины возникновения ошибок
 

docs/vacancies.md

@@ -14,7 +14,6 @@
 <a name="creation-results"></a>
 <a name="conditions"></a>
 <a name="edit"></a>
-<a name="edit_more"></a>
 <a name="other-actions"></a>
 <a name="prolongate"></a>
 <a name="prolongate-info"></a>

docs_eng/employer_vacancies.md

@@ -4,7 +4,6 @@
 * [Publishing job vacancies](#creation)
 * [Conditions for filling out fields when publishing and adding vacancies](#conditions)
 * [Editing vacancies](#edit)
-* [Editing billing type or vacancy manager](#edit_more)
 * [Extending vacancies](#prolongate)
 * [Information about possible vacancy extension](https://api.hh.ru/openapi/en/redoc#tag/Vacancy-management/operation/get-prolongation-vacancy-info)
 * [Published vacancy list](#active)
@@ -38,112 +37,7 @@ See also:
 <a name="edit"></a>
 ## Editing vacancies
 
-`PUT /vacancies/{vacancy_id}`
-
-* `ignore_duplicates=true` - ignore [duplicates](#edit-ignore-duplicates) after editing the vacancy.
-
-Editing is similar to publishing a vacancy but with an option to send individual fields in an object for partial editing.
-Compound fields (such as `salary`, `contacts`, `professional_roles`) can be edited only as a whole; 
-the entire object will be sent. For example, to edit salary currency, you will also have to change the salary value;
-to change the specialisation you will have to send a full list.
-
-### Editable fields
-
- field                      | description                                                          
-----------------------------|----------------------------------------------------------------------
- name                       | title                                                                
- description                | description                                                          
- key_skills                 | key skills                                                           
- schedule                   | work schedule                                                        
- experience                 | required work experience                                     
- employment                 | type of employment                                                   
- professional_roles         | list of professional roles
- salary                     | salary                                                               
- address                    | address                                                              
- test                       | test task                                                           
- department                 | department                                                           
- code                       | internal vacancy code                                          
- response_letter_required   | mandatory application cover letter              
- accept_handicapped         | indication that the job is available for applicants with disabilities   
- accept_kids                | indication that the job is available for applicants as young as 14 years old
- response_notifications     | notification about new applications                 
- allow_messages             | "message candidate" option for this vacancy
- contacts                   | contact info                     
- custom_employer_name       | company name for anonymous vacancies                                 
- response_url               | application URL for direct vacancies   
- accept_incomplete_resumes  | whether it is possible to apply with an incomplete resume   
- branded_template.id        | <a name="branded-template-field"></a> branded vacancy description from [directory](https://api.hh.ru/openapi/en/redoc#tag/Employer-info/operation/get-vacancy-branded-templates-list) |
- languages                  | list of languages
-driver_license_types        | driver's license category. Item of the `driver_license_types` [dictionary](https://api.hh.ru/openapi/en/redoc#tag/Public-directories/operation/get-dictionaries)
-video_vacancy               | video vacancy data including video download link
-
-The remaining fields are read-only or can only be set during initial publication.
-
-### Response
-
-A successful response contains a code `204 No Content`.
-
-### Errors
-
-* `404 Not Found` – vacancy for editing not found.
-* `403 Forbidden` – current user cannot edit vacancies.
-* `400 Bad Request` – error found in a field when editing the vacancy.
-* <a name="edit-ignore-duplicates"></a> `403 Forbidden` –
-  the vacancy cannot be edited, because editing makes the vacancy
-    similar to another vacancy from the same employer. If you are sure that
-    a duplicate is necessary, you can add
-  `PUT /vacancies/{vacancy_id}?ignore_duplicates=true`.
-
-In addition to the HTTP code, the server can return a description of the [error reason](errors.md#vacancies-create-n-edit).
-
-
-<a name="edit_more"></a>
-### Editing billing type or vacancy manager
-
-You can only improve the vacancy type.
-
-Editing the billing type of a vacancy or passing the vacancy to another
-manager in the company is similar to editing `PUT /vacancies/{vacancy_id}`. 
-The only peculiarity is that the following fields (`billing_type` and `manager`) 
-must be sent separately from the remaining fields of the vacancy.
-
-```
-PUT /vacancies/{vacancy_id}
-```
-
-```json
-{
-    "billing_type": {
-        "id": "premium"
-    }
-}
-```
-
-and
-
-```
-PUT /vacancies/{vacancy_id}
-```
-
-```json
-{
-    "manager": {
-        "id": "1337"
-    }
-}
-```
-
-### Response
-
-A successful response contains a code `204 No Content` and is body-less.
-
-### Errors
-
-* `404 Not Found` – vacancy for editing not found.
-* `403 Forbidden` – current user cannot edit vacancies.
-* `403 Forbidden` – `billing_type` and `manager` are passed along with others.
-
-In addition to the HTTP code, the server can return a description of the [error reason](errors.md#vacancies-create-n-edit).
+>!! Method is defined in [OpenAPI](https://api.hh.ru/openapi/en/redoc#tag/Vacancy-management/operation/edit-vacancy)
 
 <a name="other-actions"></a>
 ### Other actions

docs_eng/errors.md

@@ -304,7 +304,7 @@ HTTP code| type| value| description
 403 | vacancies | duplicate | a similar job has already been published; the [response](#vacancies-duplicate-response) contains information about duplicate jobs; this error can be disabled by force (when [adding](employer_vacancies.md#creation) or [editing](employer_vacancies.md#edit-ignore-duplicates))
 403 | vacancies | creation_forbidden | jobs cannot be published by the current manager
 403 | vacancies | unavailable_for_archived | you cannot edit an archived job
-403 | vacancies | conflict_changes | a conflict was detected between changes to the job's data ([read more](employer_vacancies.md#edit_more))
+403 | vacancies | conflict_changes | a conflict was detected between changes to the job's data ([read more](https://api.hh.ru/openapi/en/redoc#tag/Vacancy-management/operation/edit-vacancy))
 
 #### Reasons for errors
 

docs_eng/vacancies.md

@@ -17,7 +17,6 @@ See also:
 <a name="creation-results"></a>
 <a name="conditions"></a>
 <a name="edit"></a>
-<a name="edit_more"></a>
 <a name="other-actions"></a>
 <a name="prolongate"></a>
 <a name="prolongate-info"></a>