Merge branch 'main' into 8-translate-docs/project/join

Author: AksonovSergei

docs/project/intro.md

@@ -3,10 +3,11 @@ sidebar_position: 1
 ---
 # About the project
 
-Do you think that making a robot is difficult and expensive? No, it's not quite true. Yes, creating a robot requires a lot of knowledge from the basics. But modern frameworks can significantly speed up this process. Most of the time and effort is spent on creating the platform - the physical structure of the robot, selecting or developing the electronics, and setting up the first movements.
 
-The goal of this project is to create a robot platform that can be easily replicated and assembled by yourself. Having a ready-made platform should lower the threshold for entering the fascinating world of robotics. The complexity of the first steps can scare off many people, but if a person has a platform that can start working in a few days, it will definitely attract more people.
+Do you think that making a robot is difficult and expensive? No, it’s not entirely true. Yes, creating a robot from scratch requires a lot of knowledge. But modern frameworks can significantly speed up this process. The most time and effort is spent creating a platform — the physical design of the robot, selecting or developing electronics, and setting up the first movements.
 
-Just imagine: in a few days, you assemble a robot that, like a robot vacuum cleaner, can map your home and move around it from point A to point B, avoiding obstacles. Sounds interesting, doesn't it?
+The goal of this project is to create a robot platform that can be easily repeated and assembled independently. Having a ready-made platform should lower the threshold for entering the exciting world of robotics. The complexity of the first steps can scare off many interested parties, but if a person has a platform that can work in just a few days, it will definitely attract more interested parties.
+
+Imagine: in a few days you assemble a robot that, like a robot vacuum cleaner, can map your house and move around it from point A to point B, avoiding obstacles. Interesting, right?
 
 The next goal of this project is to create a student community around this platform that will develop it and carry out their own projects based on it, expanding and scaling its capabilities.

docs/project/links.md

@@ -1,13 +1,14 @@
 import YouTubeVideo from '@site/src/components/youtube'
 
-# Корисні ресурси 
-## Розробкою роботів
+# Useful resources
+## For robots development
 
 ### ROS2 Tutorials 
 - https://docs.ros.org/en/jazzy/Tutorials.html
+- Visual Studio Code ROS Extension: https://www.youtube.com/watch?v=PBbEhRf8QjE&ab_channel=Polyhobbyist
 
 ### Articulated Robotics
-Дуже гарні матеріали від **Josh Newans** 
+Excellent works from **Josh Newans** 
 - https://articulatedrobotics.xyz/
 - https://www.youtube.com/c/ArticulatedRobotics
 
@@ -19,10 +20,10 @@ import YouTubeVideo from '@site/src/components/youtube'
 - https://www.theconstruct.ai/
 - https://www.youtube.com/@TheConstruct
 
-### Наукова робота Enhancing visual autonomous navigation in row-based crops with effective synthetic data generation
+### Sceintific work Enhancing visual autonomous navigation in row-based crops with effective synthetic data generation
 - https://link.springer.com/article/10.1007/s11119-024-10157-6
 
-## Проэкти роботів
+## Robots projects
 ### Jet Propulsion Laboratory Space Robots for Everyone
 - https://jplopensourcerover.com/#!/home
 - https://github.com/nasa-jpl

docs/project/roadmap.md

@@ -1,13 +1,13 @@
 ---
 sidebar_position: 3
 ---
-# Roadmap проекту
+# The project roadmap
 
-|#| Етап|Опис|
-| --- | --- |--- | 
-| 1 | **Розробка шасі робота** | - Створення легкої у виготовленні конструкції шасі з чотирма моторами, кожен з яких оснащений енкодером для вимірювання швидкості обертання коліс. <br/> - Розробка контролера моторів на базі STM32 з керуванням через послідовний інтерфейс. |
-| 2 | **Інтеграція ROS2 та управління через Bluetooth Gamepad**              | Налаштування мінімальної конфігурації ROS2 на Raspberry Pi для управління шасі робота за допомогою стандартного Bluetooth-джойстика.                   |
-| 3 | **Запуск навігації в приміщенні з використанням лідара**               | Вибір і налаштування одного з фреймворків ROS2 для створення карти приміщення та автономного переміщення між точками А і Б.                            |
-| 4 | **Запуск навігації на відкритому просторі з використанням GPS**        | Вибір та налаштування одного з фреймворків ROS2, який забезпечить автономну навігацію за визначеними маршрутними точками з використанням GPS.          |
-| 5 | **Реалізація навігації в приміщенні з використанням лише камери**      | Вибір відповідного фреймворку для реалізації навігації з використанням тільки камери для створення карти приміщення та автономного пересування.        |
-| 6 | **Запуск профільних проєктів**                                         | Початок роботи над спеціалізованими проєктами на основі готової платформи робота з розширенням її можливостей. |
+|#| Step|Description|
+|--- | --- |--- |
+| 1 | **Development of the robot chassis** | - Creation of an easy-to-manufacture chassis design with four motors, each equipped with an encoder for measuring the speed of rotation of the wheels. <br/> - Development of a motor controller based on STM32 with control via a serial interface. |
+| 2 | **Integration of ROS2 and control via Bluetooth Gamepad** | Setting up the minimum configuration of ROS2 on Raspberry Pi to control the robot chassis using a standard Bluetooth joystick. |
+| 3 | **Launching indoor navigation using lidar** | Selecting and configuring one of the ROS2 frameworks to create a map of the room and autonomous movement between points A and B. |
+| 4 | **Launching outdoor navigation using GPS** | Selecting and configuring one of the ROS2 frameworks that will provide autonomous navigation along specified waypoints using GPS. |
+| 5 | **Implementation of indoor navigation using only the camera** | Selection of an appropriate framework for implementing navigation using only the camera to create a room map and autonomous movement. |
+| 6 | **Launch of profile projects** | Start of work on specialized projects based on a ready-made robot platform with expansion of its capabilities. |

docs/project/tasks.md

@@ -4,70 +4,70 @@ sidebar_position: 2
 
 import YouTubeVideo from '@site/src/components/youtube';
 
-# Завдання
-Тут ви можете знайти перелік завдань, серед яких ви можете обрати завдання собі.
+# Tasks
+Here you can find a list of tasks that you can choose for yourself.
 
-## Розробка електроніки
+## Electronics development
 
-Ми шукаємо студентів, котрі мають бажання взяти участь у розробці друкованих плат.
-Для розробки друкованих плат ми використовуємо [**KiCAD**](https://www.kicad.org/)
+We are looking for students who are willing to participate in development of printed circuit boards.
+For development these boards we use [**KiCAD**](https://www.kicad.org/)
 
-### Плата живлення Raspberry Pi
-Живлення Raspberry Pi від акумулятора потребує стабільного й доволі потужного DC-DC перетворювача.
+### Raspberry Pi power board
+Raspberry PI power from the battery needs to have stable and quite powerful DC-DC converter.
 
-Ми вже розробили перший прототип:
+We have already developed the first prorotype:
 
 ![RPI HAT](../platform/rpi_power_hat/img/rpihat_v1.png)
 
-Але, як і очікувалось, були допущені помилки й з'явились побажання щодо вдосконалення.
+But as expected mistakes were made and wishes were expressed for an improvement.
 
-### Контролер шасі
+### Chassis controller
 
-Для керування моторами робота потрібен контролер шасі. На сьогоднішній день ми використовуємо [BeagleBone Blue](https://www.beagleboard.org/boards/beaglebone-blue). Але він занадто дорогий й останнім часом його дуже складно придбати. Тому ми хочемо розробити власний контролер на базі STM32.
+A chassis controller is required to control the robot's motors. Currently, we're using [BeagleBone Blue](https://www.beagleboard.org/boards/beaglebone-blue). But it's too expensive and impossible to buy lately. That's why we want to develop our own controller on STM32 base.
 
-**Основні функції:**
-* Керування чотирма моторами постійного струму
-* Зчитування показань енкодерів моторів
-* Зчитування показань й калібрування акселерометра
-* Зчитування показань й калібрування компаса
-* Зчитування даних з GPS модуля
-* ПІД регулятор швидкості коліс
-* Ethernet інтерфейс для прийому команд керування
-* Виходи PWM для керування сервоприводами.
+**Main features:**
+* Control of four DC motors 
+* Reading motor encoder readings
+* Accelerometer reading and calibration
+* Compass reading and calibration
+* GPS module data reading
+* PID wheel speed regulator
+* Ethernet interface for receiving control commands
+* PWM outputs for servomotor control.
 
-Функціональна схема: [Архітектура системи](../platform/overview/overview.md).
+Functional diagram: [Архітектура системи](../platform/overview/overview.md).
 
-На першому етапі, так як є ризик зробити багато помилок, ми плануємо розробити плату у вигляді плати розширення до STM32-Discovery. Потім, коли ми вже здобудемо досвід, ми плануємо розробити повноцінну плату з встановленим на ній мікроконтролером STM32.
+At the first stage, since there is a risk of making plenty of mistakes, we're planning to develop the board as a STM32-Discovery expansion board. Then, when we have gained experience, we're going to develop a full-fledged board with STM32 microcontroller installed on it.
 
-## Розробка вбудованого програмного забезпечення 
+## Embedded software development
 
-Контролер шасі потребує програмного забезпечення для STM32. Ми шукаємо команду студентів, які візьмуть участь у його розробці.
-Дивись опис завдання по розробці шасі для того, щоб ознайомитись з основними функціями.
+The chassis controller requires a STM32 software. We're looking for a students team, who will participate in it's development.
+See the chassis design task description for basic functionality.
 
-## Розробка конструкції робота
-На першому етапі ми вирішили зробити якомога простішу конструкцію, щоб збірка не потребувала спеціальних знарядь, а матеріали можна було легко й недорого придбати. Тому наш робот зараз виглядає ось так:
+## Robot design development
+At the first stage, we've decided to make the design as simple as possible, so that the assembly wouldn't reqiure special tools and the materials could be purchased easily and inexpensively. Therefore, our robot now looks like this: 
 ![KPI Rover](./img/kpi_rover.png)
 
-У цієї конструкції основний недолік - цього робота не можна використовувати на дворі при поганих погодних умовах. Також це шасі має погану прохідність, так як нема підвіски.
+In this design, the main disadvantage of this robot - he cannot be used in bad weather conditions. Also, the chassis has poor cross-country ability due to lack of suspension.
 
-Ми шукаємо групу студентів, котра зможе розробити, надрукувати й зібрати для проєкту сучасне шасі робота.
+We're looking for students, who can design, print and assemble a modern robot chassis for this project.
 
-Ось приклад непоганого opensource проєкту:
+Here's an example of a good open source project:
 
 <YouTubeVideo videoId="90HxqwZaWRA" />
 
 ## DevOps and Dev Process
 
-Кількість учасників проєкту зростає. Також зростає кількість вихідного коду й його складність. Тому, щоб спростити процес розробки й запобігти випадкам, коли зміни порушують роботу програмного забезпечення, нам потрібно:
-1. **Описати процес розробки:**
-   * Як приєднатись до проєкту.
-   * Як створити завдання?
-   * Як створити робочу гілку (branch)?
-   * Як створити PR?
-   * Вимоги до комітів
-   * Вимоги до code style
-   * Вимоги до покриття unit-тестами
-   * Вимоги до статичного аналізу коду
-   * й т.п.
-2. **Налаштувати CI використовуючи GitHub Actions**
-3. **Налаштувати Release процес використовуючи GitHub Packages**
+The number of project participants is growing. The amount of source code and it's complexity is also increasing. Therefore, to simplify the development process and prevent changes from software breaking, we need to:
+1. **Describe the development process:**
+   * How to join the project.
+   * How to create a task?
+   * How to create a working branch?
+   * How to create a PR?
+   * Commit requirements
+   * Code style requirements
+   * Unit tests coverage requirements
+   * Static code analysis requirements
+   * etc.
+2. **Configure CI using GitHub Actions**
+3. **Configure Release process using GitHub Packages**