-
Notifications
You must be signed in to change notification settings - Fork 3
[E]nvironment
“You can't trust code that you haven't written entirely yourself.”
― Ken Thompson
Building a project should be a single trivial operation. You should not have to check many little pieces out from source code control. You should not need a sequence of arcane commands or context dependent scripts in order to build the individual elements. You should not have to search near and far for all the various little extra JARs, XML files, and other artifacts that the system requires. You should be able to check out the system with one simple command and then issue one other simple command to build it.
cd D:\Projects
git clone https://github.com/SaintZet/FiscalDeviceStatusDecoder
dotnet publish -p:PublishSingleFile=true -r win-x64 -c Release --self-contained false
[E01]: Построение состоит из нескольких этапов
Построение проекта должно быть одной тривиальной операцией. Без выборки многочисленных фрагментов из системы управления исходным кодом. Без длинных серий невразумительных команд или контекстно-зависимых сценариев для построения отдельных элементов. Без поиска дополнительных файлов в формате JAR, XML и других артефактов, необходимых для вашей системы. Сначала вы проверяете систему одной простой командой, а потом вводите другую простую команду для ее построения.[E01]: Побудова складається з кількох етапів
Побудова проекту має бути однією очевидною операцією. Без вибірки численних фрагментів із системи керування вихідним кодом. Без довгих серій незрозумілих команд чи контекстно-залежних сценаріїв для побудови окремих елементів. Без пошуку додаткових файлів у форматі JAR, XML та інших артефактів, які необхідні для вашої системи. Спочатку ви перевіряєте систему однією простою командою, а потім вводите іншу просту команду для її побудови.You should be able to run all the unit tests with just one command. In the best case you can run all the tests by clicking on one button in your IDE. In the worst case you should be able to issue a single simple command in a shell. Being able to run all the tests is so fundamental and so important that it should be quick, easy, and obvious to do.
[E02]: Тестирование состоит из нескольких этапов
Все модульные тесты должны выполняться всего одной командой. В лучшем случае все тесты запускаются одной кнопкой в IDE. В худшем случае одна простая команда вводится в командной строке. Запуск всех тестов — настолько важная и фундаментальная операция, что она должна быть быстрой, простой и очевидной.
[E02]: Тестування складається з кількох етапів
Усі модульні тести повинні виконуватись лише однією командою. У кращому випадку всі тести запускаються однією кнопкою IDE. У найгіршому випадку одна проста команда вводиться в командному рядку. Запуск усіх тестів — настільки важлива та фундаментальна операція, що вона має бути швидкою, простою та очевидною.
This wiki document contains a lot of information, please take your time and read these carefully.
If you run into any trouble, you may start by understanding how this works.
Be sure to read the CONTRIBUTING guidelines before reporting a new issue or open a pull request.
If you have any questions about the Heuristics for "Clear Code" usage or want to share some information with the our community, please go to one of the following places: