1
0
mirror of https://github.com/ru-de/faq.git synced 2024-11-09 12:11:02 +00:00
faq-de/CONTRIBUTING.md
2018-01-02 19:28:53 +01:00

4.9 KiB
Raw Blame History

Спасибо, что решили помочь проекту и внести свой вклад в его развитие.

Нам очень поможет, если при создании Pull Request вы будете придерживаться следующих рекомендаций:

Какая информация приветствуется?

  • Информация, которая будет отвечать на вопросы, часто возникающие у большинства вновь приехавших или собирающихся приехать в Германию. Хорошим примером может выступать страница о детских пособиях. Все мы так или иначе проходим через определенный круг задач, которые надо решить до приезда, по приезду и в дальнейшем: найти работу, оформить документы, найти квартиру, купить или перевезти машину, оформить BlueCard и т.д. и т.п.

  • Личный опыт, позволяющий сэкономить время и/или деньги в каких-то ситуациях, где достижение результата подвержено каким-то субъективным факторам или не имеет четко определенной процедуры. Хороший пример - получение NE, несмотря на то, что в требуемых документах указывается необходимость сертификата A1 после 33 месяцев, известны случаи получения NE и без него. Другим хорошим примером можно считать оформление термина в Burgeramt, когда даже если ближайших терминов нет, это еще не означает, что они не появятся там через пять минут.

Какая информация не приветствуется?

  • Объемная дополнительная информация, которая уже широко представлена на других ресурсах, имеет смысл просто дать на нее ссылку и кратко описать, что там можно найти.

  • Что-то очевидное и само собой разумеющееся, информация, не отвечающая на какой-то конкретный вопрос.

Как оформить?

  • Приветствуется литературный русский язык с соблюдением пунктуации, без использования сленга. Например, вместо "тачка" лучше написать "автомобиль".

  • Постарайтесь избегать эмоциональных окрасок. Вместо "очередь меня взбесила", лучше написать "в это время уже была большая очередь".

  • Личный опыт, представленный в виде повествования, приветствуется оформлять в виде цитаты. Для цитирования поставьте "> " в начало строки. Текст будет выглядеть следующим образом: "> Документы почтой можно было не слать, ответ..."

После создания Pull Request

После создания Pull Request измененные файлы будут проверены роботом на содержание орфографических ошибок и недоступные ссылки, дождитесь пожалуйста выполнения проверок, если какой-то check не прошел, посмотрите лог, возможно где-то допущена опечатка, использовано не словарное слово, либо ссылка на какую-то страницу недоступна. В случае если слово, на которое ругается проверка является широко употребимым, можно внести его в словарь, для этого добавьте его в файл "files/dictionary.dic". В случае если ссылка на самом деле доступна, но отдает нестандартный ответ, можно внести такой ответ как корректный в файл "files/known_url.csv"