English version draft

Assisted-by: Claude:claude-4.6-sonnet

Introduction/README.md

@@ -1,16 +1,16 @@
-# Введение в HDL и работу с ПЛИС
+# Introduction to HDL and Working with FPGAs
 
-Неподготовленному человеку может показаться что на этих лабах мы будем заниматься изучением Ещё Одного Бесполезного Языка Программирования, и с таким отношением по окончанию курса ваше мнение скорее всего не изменится. Данный раздел содержит документы, призванные подготовить вас к выполнению лабораторных работ, немного изменить ваш взгляд на некоторые вещи.
+To an unprepared person, it may seem that in these labs we will be studying Yet Another Useless Programming Language, and with that attitude your opinion will most likely not change by the end of the course. This section contains documents intended to prepare you for the lab assignments and to shift your perspective on a few things.
 
-Чем глубже вы проникнитесь содержимым этих документов, тем безболезненнее для вас пройдет процесс изучения дисциплины.
+The deeper you engage with the content of these documents, the smoother your experience in studying this course will be.
 
-Порядок чтения следующий:
+The recommended reading order is as follows:
 
-1. "[What is HDL](What%20is%20HDL.md)" — в документе описано, что такое **Языки Описания Аппаратуры** (**Hadrware Description Languages**, **HDL**).
-2. "[How FPGA Works](./How%20FPGA%20works.md)" — в документе описано, как работает ПЛИС изнутри.
-3. "[Sequential logic](./Sequential%20logic.md)" — в документе описана классификация цифровой логики (комбинационная / последовательностная), эволюция бистабильных ячеек от петли инверторов до D-триггера, явление метастабильности и критический путь.
-4. "[Implementation Steps](./Implementation%20steps.md)" — в документе описано процесс реализации проекта от HDL-описания цифровой схемы до конфигурации этой схемой ПЛИС. Его прочтение даст большее понимание о принципе работы ПЛИС и позволит посмотреть на некоторые её реальные элементы изнутри.
+1. "[What is HDL](What%20is%20HDL.md)" — this document describes what **Hardware Description Languages** (**HDL**) are.
+2. "[How FPGA Works](./How%20FPGA%20works.md)" — this document explains how an FPGA works internally.
+3. "[Sequential logic](./Sequential%20logic.md)" — this document covers the classification of digital logic (combinational / sequential), the evolution of bistable cells from an inverter loop to a D flip-flop, the phenomenon of metastability, and the critical path.
+4. "[Implementation Steps](./Implementation%20steps.md)" — this document describes the process of implementing a project, from an HDL description of a digital circuit to the configuration of an FPGA with that circuit. Reading it will give a deeper understanding of how an FPGA works and allow you to look at some of its real internal elements.
 
-Обратите внимание, что во втором абзаце не было использовано слово "поймёте". Часто это слово несет не тот смысл. Можно прочесть документ и **понять** каждое его слово, но не постигнуть смысла, который в этих слова лежал (**слышать**, но не **слушать**). В романе Роберта Хайнлайна "_Чужак в чужой стране_" вводится особое марсианское слово, непереводимое на земной язык: "**грокать**", которое имеет множество значений. В первом приближении можно подумать, что это слово переводится как "понять", однако это не так. Например, на Марсе очень мало воды и процесс её питья марсианами (по сюжету романа, разумеется) является целым ритуалом, и обозначается этим же словом "грокать". Грокать что-то — означает что это что-то стало частью твоего естества. В отношении информации это означает, это информация стала частью тебя, изменила то, как ты думаешь. Грокать — это постичь что-то на самом глубинном уровне, это видеть девушку в красном сквозь завесу падающих зеленых символов. Даже этот абзац расписан для того, чтобы вы не просто поняли, что эти документы важно понять — а грокнули то, что эти документы важно грокнуть.
+Note that the second paragraph did not use the word "understand." That word often carries the wrong meaning. One can read a document and **understand** every word without grasping the meaning behind those words (**hearing** without **listening**). In Robert Heinlein's novel _Stranger in a Strange Land_, a special Martian word is introduced that cannot be translated into any Earth language: "**grok**," which carries many meanings. At first glance, one might think it simply means "to understand," but that is not so. For example, water is extremely scarce on Mars, and the act of drinking it (in the story, of course) is a full ritual, also described by the word "grok." To grok something means that it has become part of your very being. Applied to information, it means that the information has become part of you and has changed the way you think. To grok is to comprehend something at the deepest possible level — to see the girl in the red dress through the curtain of falling green symbols. Even this paragraph is written so that you do not merely understand that these documents are important to understand — but grok that these documents are important to grok.
 
-На самом деле не важно, каким словом будет обозначен результат вашего прочтения. Важно то, что если после того как вы прочтете эти документы, на лабах вы будете употреблять словосочетания наподобие: "_объявляем переменную_", значит что-то пошло не так, и образ вашего мышления все еще заперт в парадигме "программирования". Это не то чтобы плохо, просто усложнит вам процесс изучения и выполнения лабораторных работ.
+In the end, it does not matter what word you use to describe the result of your reading. What matters is this: if after reading these documents you still find yourself using phrases like "_declaring a variable_" during lab sessions, then something has gone wrong, and your way of thinking is still locked in the "programming" paradigm. That is not necessarily bad — it will simply make the process of studying and completing the lab assignments more difficult.