Please read the organization's governance rules and contribution guidelines before proceeding.
ЭФ>Какая между ними разница, примерно как между Уголовным кодексом (УК) и Кодексом Административных правонарушений (КоАП)? ЭФ>Или это другое?
Разница здесь такая же, как и на русском между понятиями "правила" и "руководства".
Правила — это декларативное описание. Какие условия должны выполняться, чтобы все было хорошо.
Руководства — это императивное описание. Какие действия нужно сделать, чтобы получить нужные результаты.
Re[2]: В чём разница между правилами и руководствами?
ЭФ>В русском языке правила вполне императивные:
ЭФ>"Душа моя, Павел. Держись моих правил: ЭФ>люби то-то, то-то, не делай того-то."
Даже если не брать в расчет, что в поэтическом произведении могут быть свои семантические нюансы — эти правила тоже скорее можно отнести к декларативным (а ля "что такое хорошо и что такое плохо").
А если уж их с большой натяжкой и считать императивными — то не просто императивными, а, если можно так выразиться, императивными "более высокого порядка". Т.е. они определяют не что надо делать с объектами реального мира, а определяют что надо делать с декларативными метаданными в своей голове (типа "присвой описанию того-то и того-то положительные веса, а описанию вот того-то присвой отрицательный вес").
Re: В чём разница между правилами и руководствами?
Please read the organization's governance rules and contribution guidelines before proceeding.
ЭФ>Какая между ними разница, примерно как между Уголовным кодексом (УК) и Кодексом Административных правонарушений (КоАП)? ЭФ>Или это другое?
Гугл вам в помощь:
Guidelines are recommendations that guide for best practices and behaviors, whereas rules are lawful and permanent guidelines that one must follow according to organizational or institutional policies. The key difference between the guidelines and the rules is that guidelines are not formal, whereas rules are formal.
К примеру если контекст вашей фразы имеет отношение к вкладыванию постов в каком-нибудь сообществе то в governance rules будет написано какой контент запрещается выкладывать и что вам будет за нарушения, а в contribution guidelines расскажут о всяких приемах как лучше оформить контент и как удобнее его запостить.
Так что это разница, примерно как между Уголовным кодексом (УК) и Кодексом строителя коммунизма ))
Re[2]: В чём разница между правилами и руководствами?
K>Правила — это декларативное описание. Какие условия должны выполняться, чтобы все было хорошо. K>Руководства — это императивное описание. Какие действия нужно сделать, чтобы получить нужные результаты.
Может наоборот, правила — императивные (ПДД, например: останавливаться на знак стоп); руководства — декларативные, не?
Re[3]: В чём разница между правилами и руководствами?
K>>Правила — это декларативное описание. Какие условия должны выполняться, чтобы все было хорошо. K>>Руководства — это императивное описание. Какие действия нужно сделать, чтобы получить нужные результаты.
P>Может наоборот, правила — императивные (ПДД, например: останавливаться на знак стоп); руководства — декларативные, не?
Не, ПДД все же тоже декларативные (даже те пункты, которые на первый взгляд кажутся императивными). Они интерпретируются примерно так: должно выполняться условие, что движение мимо знака стоп должно быть не непрерывным, а с остановкой.
А вот если интсруктор рассказывает ученику, как надо проезжать знак стоп (примерно так: как увидел знак стоп — сбрось скорость, плавно остановись перед знаком, задержись хотя бы на секунду, осмотрись, и если все чисто — езжай дальше) — это уже императивное руководство.
Re: В чём разница между правилами и руководствами?
ЭФ>То есть, правила описывают, что произойдёт, если сделать так, как нельзя делать.
Вовсе не обязательно детально описывать что произойдет. Достаточно абстрактного указания: если сделать так, как нельзя делать — будет плохо.
M>> А руководство рассказывает как достичь результата.
ЭФ>Но если сделать другим способом, то решение просто не примут.
Кто не примет, почему не примет? Если только в каких-нибудь особых случаях, где имеет место жесткая сертификация процесса чего-нибудь — но такое бывает редко.
Re[4]: В чём разница между правилами и руководствами?
K> Достаточно абстрактного указания: если сделать так, как нельзя делать — будет плохо.
Нет. Всё что можно протестировать — будет протестировано. Поэтому угроза должна быть конкретной. Никаких "последних китайских предупреждений".
M>>> А руководство рассказывает как достичь результата. ЭФ>>Но если сделать другим способом, то решение просто не примут. K> Кто не примет,
Мейнтейнеры репозитория
K> почему не примет?
Потому что код не соответствует coding guidelines.
K> такое бывает редко
Please read the organization's governance rules and contribution guidelines before proceeding.
ЭФ>Какая между ними разница,
Помимо указанных отличий общих понятий, в данном случае governance rules относятся к управлению проектом; и применяются соответственно теми, кто управляет. А contribution guidelines относятся ко всем, кто пушит код.
ЭФ>примерно как между Уголовным кодексом (УК) и Кодексом Административных правонарушений (КоАП)?
Примерно как между Руководством администратора и Руководством пользователя.