Участвовать

Pipeline полезен только пока он точен. Помогите ему оставаться таким.

Зачем участвовать

Правила переезда меняются постоянно. Каждый этап Pipeline ссылается на официальный источник с датой проверки. Чем дольше эти даты не обновляются, тем менее полезным становится Pipeline. Контрибьюторы — это то, что держит его честным.

Каждое улучшение публикуется как открытый коммит под именем автора.

Кому это подойдёт

Вы хорошо подходите для участия, если применимо что-либо из этого:

• Вы переехали в Хорватию и помните, что вызвало затруднения.
• Вы сейчас в процессе переезда и замечаете моменты, которые Pipeline упустил.
• Вы работаете рядом с темой переезда — иммиграционный юрист, бухгалтер, консультант по релокации, HR-специалист — и можете указать на устаревшие правила или уточнить пункт чеклиста.
• Вы переезжали в другую страну или из неё и хотите помочь проекту со временем покрыть больше направлений.
• Вы просто внимательный читатель и заметили битую ссылку, опечатку или утверждение, которое больше не актуально.

Не обязательно быть техническим специалистом. Исправления на уровне опечаток и формулировок ценны не меньше новых пунктов чеклиста.

Что можно сделать

Проверить и обновить источник. Каждый пункт чеклиста ссылается на официальную государственную или европейскую страницу с датой asOf. Если источник переехал, изменил номер или само правило поменялось — обновите ссылку и дату.

Добавить недостающий пункт чеклиста. Если реальный шаг подкосил вас при переезде, а в Pipeline его нет — добавьте его в нужный этап со ссылкой на источник.

Указать подводный камень. В каждом этапе есть блок gotchas — неочевидные ловушки, которые не вписываются в чеклист. Добавьте свою.

Поделиться опытом. Сроки («OIB занял 3 часа в Загребе и 3 дня в Сплите»), стоимости, муниципальные особенности — это всё живёт в заметках к пунктам и в gotchas.

Добавить измерение персоны. Pipeline уже фильтруется по визе, семье и питомцам. Если вы заметили, что пункт ведёт себя по-разному для вашей категории, добавьте блок appliesTo или предложите новое измерение персоны.

Улучшить текст. Более чёткие формулировки, лучшее форматирование, исправление неуклюжего английского.

Перевести. Благодаря разделению данных и строк (см. ниже) перевод выполняется механически: скопируйте content/stages/<slug>.md в content/stages/<slug>.<lang>.md и переведите только строковые значения. Все URL, даты и фильтры остаются каноническими в data/stages/*.yaml — поэтому перевод не может разойтись с источником истины.

Как внести вклад

Полные исходники лежат на GitHub. Три способа отправить изменение, по возрастанию сложности:

1. Открыть issue. Опишите изменение, которое хотели бы видеть. Самый быстрый путь, если вы не готовы редактировать файлы напрямую. Приложите ссылку на источник, если она у вас есть.
2. Отредактировать файл на GitHub и открыть pull request. На каждой странице этапа есть ссылка «edit on GitHub». Нажмите, внесите правку в браузере, и GitHub проведёт вас через создание pull request. Локальная настройка не нужна.
3. Склонировать, отредактировать и открыть pull request. Стандартный проект Hugo. hugo server поднимает сайт локально по адресу http://localhost:1313/ohmoveagain/. Структурные факты (URL, даты asOf, фильтры персон) живут в data/stages/*.yaml. Переводимые строки (метки, заметки, подписи источников) — в front-matter content/stages/*.md под itemStrings.<item-id>. Шаблоны объединяют их по ID пункта во время сборки.

Каждый pull request рассматривается публично. Ответ обычно приходит в течение нескольких дней.

Планка качества

Чтобы Pipeline оставался достоверным, вклад должен соответствовать нескольким правилам:

• Ссылайтесь на официальный источник — государственный, европейский или признанный международный орган. Темы на Reddit, посты в блогах и личные форумы источниками не считаются.
• Ставьте дату asOf — день, когда вы проверили ссылку. Так читатель понимает, насколько свежее правило.
• Будьте точны. «Апостилированное свидетельство о рождении» лучше, чем «бумаги о рождении». «≥ 21 день до поездки» лучше, чем «за несколько недель до поездки».
• Пишите простым английским. Короткие предложения. Действительный залог. Без жаргона, который пришлось бы искать в словаре.

Чем Pipeline не является

Граница в охвате важна не меньше содержания. Чтобы Pipeline оставался полезным:

• Он не покрывает глубокий анализ рынка жилья, рейтинги школ или сравнение систем здравоохранения. Эта глубина — для специализированных ресурсов, и дублировать её здесь означало бы делать Pipeline устаревшим быстрее, чем контрибьюторы успевают его править.
• Он не даёт юридических, налоговых или иммиграционных консультаций. Каждый пункт носит ориентировочный характер — всегда сверяйтесь с официальным источником или лицензированным местным специалистом до действий.
• Он пока не покрывает переезд в страны, кроме Хорватии. Расширение возможно, когда контент по Хорватии станет зрелым и появится сеть контрибьюторов.

Лицензия

Весь контент публикуется под лицензией MIT. Используйте, адаптируйте и распространяйте свободно — упоминание авторства приветствуется, но не обязательно.

Связь

Открытый вопрос — issue на GitHub. Для приватных тем (например, вы хотите внести вклад, но не хотите связывать имя с чувствительной иммиграционной темой) контактный email есть в README репозитория.