From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Date: Sun, 17 Dec 2017 03:09:27 +0300 (MSK) From: Ivan Zakharyaschev To: devel-newbies@lists.altlinux.org Message-ID: User-Agent: Alpine 2.20 (LFD 67 2015-01-07) MIME-Version: 1.0 Content-Type: multipart/mixed; BOUNDARY="1807885841-1756190914-1513469367=:7714" Subject: [newbies] sanity rules X-BeenThere: devel-newbies@lists.altlinux.org X-Mailman-Version: 2.1.12 Precedence: list Reply-To: "devel@ where you _can_ ask" List-Id: "devel@ where you _can_ ask" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 17 Dec 2017 00:09:27 -0000 Archived-At: List-Archive: This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. --1807885841-1756190914-1513469367=:7714 Content-Type: text/plain; format=flowed; charset=KOI8-R Content-Transfer-Encoding: 8BIT Hi! У меня при общении с newbies сформулировались такие общие соображения о том, к чему стремиться, о чём волноваться. 0. Не надо делать что-то непонятное, магическое. (Если волнует непонятная магия, то можно спросить, что это, или спросить, где про это узнать.) 1. Беспроблемность использования подготовленного пакета. Речь не идёт о полной безошибочности, но ошибка, которую трудно отловить -- это бОльшая проблема, и хорошо, если во время подготовки пакета её удастся малыми силами предупредить. (Более опытные мейнтейнеры могут подсказать, на что ради этого обратить внимание во время подготовки пакета. Например, посмотреть в лог сборки. Если волнуют какие-то предупреждения и непонятно, свидетельствуют ли они о серьёзных проблемах, то можно спросить. Волновать должно всё непонятное -- ср.п.0.) 2. Беспроблемность для дальнейшей работы мейнтейнеров подготовленного пакта, в т.ч. массовых изменений пакетов в Sisyphus "роботами". (Важна понятность сделанного, когда другие будут читать ваши изменения или роботы анализировать. Важно удобство для разных возможных действий мейнтейнеров/роботов с подготовленным исходным пакетом в будущем. Важно, чтобы в будущем пакет требовал внимания (автоматически) тогда, когда в нём что-то сломалось, пошло не так, как было проверено; и по возможности -- только тогда, т.е. не требовать просмотра глазами каждый раз. Когдя нет автоматических failures, когда что-то пошло не так, может сложиться две плохих ситуации: каждый раз смотрим глазами, потому что волнуемся: вдруг что-то пошло не так, и теряем силы и время или вообще не смотрим, потому что нет сил, и пропустим настоящую ошибку -- ср.п.2.) Печально, когда понимание этого теряется и разумное обсуждение сборки пакетов заменяется какими-то догматическими спорами или тыканием пальцем в другие пакеты, т.е. бесполезной тратой сил. Пример: Warning от компилятора может свидетельствовать о серьёзной ошибке (например, использование функции без прототипа в C). Серьёзную ошибку не надо оставлять в подготовленном пакете. (Ср. п.1.) Если warning-ов не осталось, то для облегчения работы мейнтейнеров (п.2) можно выставить -Werror. А то каждый раз придётся глазами проверять, нет ли предупреждений (и при сборке новых версий, и при изменении сборочной среды и требований по качеству к пакетам). Если warning-и несерьёзные, но их мало, то проще сразу код поправить, чем каждый раз о них думать. (Ср. п.2.) -- Best regards, Ivan --1807885841-1756190914-1513469367=:7714--