Как принять участие в переводе

Для того чтобы взяться за перевод статьи, вам следует выполнить следующие шаги:

1. Перед началом работы над переводом форкните проект spring-guides-translation на свой аккаунт GitHub.

2. Если вы уже ранее форкнули этот проект, убедитесь, что ваш локальный репозиторий обновлен до последней версии. В противном случае синхронизируйте его или удалите старый форк и создайте новый.

3. Все статьи, требующие перевода, находятся в папке source. Выберите статью, которую хотите перевести, убедившись, что она еще не занята другим переводчиком. Добавьте в начало файла строку "【Переводчик: [Имя]】", где вместо имени укажите свое имя или никнейм. Затем сделайте push и отправьте pull request (PR) в основной репозиторий spring-guides-translation, указав тему "【Переводчик: [Имя]】".

4. Есть несколько способов заявиться на перевод статьи:

   а) Посмотрите оригинальный текст статьи после синхронизации вашего форка. Если в первой строке есть отметка от другого переводчика или его ID на GitHub, значит статья уже занята.
   
   б) Если вы заметили, что статья была занята, но давно не обновлялась (более трёх недель), вы можете сообщить об этом в обсуждательской группе. Если прежний переводчик прекратил работу или долго не отвечает, вы можете запросить статью.
   ```5. После того как вы получили статью для перевода, переведите её согласно рекомендованному формату. Обязательно обновите информацию о переводе в конце статьи, заменив "译者：[译者ID](https://github.com/译者ID)" своим ID на GitHub.
   

5. После завершения перевода, сделайте push для переведённой статьи в папку source (удалите оригинальный файл и замените его переведённым).

6. Отправьте pull request (PR) для переведённой статьи.

7. Подождите проверки и публикации переведённого материала. После слияния переведённой статьи в основной репозиторий, вы можете обратиться к проверяющему через группу.

8. Для новых переводчиков, если у вас нет опыта перевода материалов Spring, можно начать с роли проверяющего.

Приступайте к работе и делитесь своими знаниями!

10. Для обеспечения качества перевода все статьи должны проходить проверку перед публикацией.

Правила перевода

Некоторые правила перевода следуют ниже:

• Формат переведённого файла: markdown

• Формат имени файла: Оригинальный заголовок.md (файл уже создан заранее, его можно редактировать).

• Введение в статью должно иметь следующий фиксированный формат: (уже создано заранее, этот раздел не следует удалять):

  • Original: Securing a Web Application

    Перевёл: xxx

    Проверил: yyy

• В конце каждой статьи должна присутствовать единая форма указания авторских прав: (уже создана заранее, этот раздел не следует удалять): > Этот текст был переведён командой spring4all.com с использованием лицензии Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

• Заголовки основного текста должны начинаться с # и строиться по иерархии.

• После фрагмента кода ``` следует указывать тип используемого языка программирования.

• Если есть изображения или другие статические ресурсы, они должны храниться в директории static, каждая статья имеет свой отдельный каталог (название каталога должно совпадать со значением номера статьи, номера статей указаны в README).

• Уважайте труд автора, не изменяйте и не убирайте содержание.

• После завершения перевода статьи отправьте Pull Request (PR), найдите проверяющего в группе перевода для проверки, а затем администратор завершает слияние.

• Если у переводчика и проверяющего есть разные предложения относительно каких-то частей, эти части могут быть вынесены на обсуждение в группу перевода для принятия решения.