diff --git a/README.md b/README.md
index b4a9837..ac96781 100644
--- a/README.md
+++ b/README.md
@@ -2,26 +2,46 @@
Some-i8080-ASM-Translator
- Транслятор ассемблера КР580ВМ80А / Intel 8080A в машинный код, с возможностью генерации листинга в разных форматах.
+ Some-i8080-ASM-Translator is a powerful, lightweight, and easy-to-use assembler translator for the KR580VM80A / Intel 8080A, developed according to the specifications in the INTEL8080 Assembly Language Programming Manual. It generates machine code and offers the ability to generate listings in various formats.
-## Ссылка на скачивание
-Скачать последнюю версию транслятора можно [здесь](https://github.com/GalaxyShad/Some-i8080-ASM-Translator/releases).
+## Download Link
+You can download the latest version of the translator in the [Releases Section](https://github.com/GalaxyShad/Some-i8080-ASM-Translator/releases).
-## Как пользоваться
-Для вывода справки вызовите:
+## Features
+
+- **Underscores in Numeric Literals**: You can define binary operands as ```1010_1100b``` for improved readability.
+- **Any Length Labels**: Use labels of any length to make your code more descriptive.
+- **Cross-platform**: Some-i8080-ASM-Translator works on all major platforms, thanks to .NET 8.0.
+- **ORG, SET, EQU, END Pseudo Instructions**: Organize your code and data with these useful pseudo instructions.
+- **DB, DS, DW**: Define and allocate bytes, strings, and words in your program.
+- **Arithmetic and Logical Expressions**: Perform complex calculations and operations with ease.
+- **Generation of Listings**: Some-i8080-ASM-Translator can generate listings in ```.DOCX```, ```.TXT```, ```.CSV```, and ```.MD``` formats for your convenience.
+- **Error Reporting**: The translator provides detailed descriptions of errors to help you quickly identify and fix issues in your code.
+
+## Limitations
+
+The translator implements all the features specified in the [INTEL8080 Assembly Language Programming Manual](https://altairclone.com/downloads/manuals/8080%20Programmers%20Manual.pdf) with the following exceptions:
+
+- No Pseudo instructions: IF AND ENDIF, MACRO AND ENDM
+- No ASCII Constant operands
+
+## How to Use
+
+To display the help, run:
```
i8080 --help
```
-Общий формат
+The general format is:
```
-i8080 <имя файла> -<флаг 1> -<флаг2>
+i8080 - -
```
-Не забудьте добавить исполняемый файл i8080 в переменные окружения PATH
+Don't forget to add the executable file i8080 to your PATH environment variables.
+
+## Available Options
-## Доступные опции
```
-c, --csv Create listing file in .csv table format
-w, --word Create listing file in .docx word table format
@@ -35,20 +55,21 @@ i8080 <имя файла> -<флаг 1> -<флаг2>
Source code file (pos. 0) Required. Input file-name including path
```
-## Пример использования
-Предположим, что имеется директория MyProject со следующей структурой:
+## Usage Example
+
+Suppose you have a directory called MyProject with the following structure:
```
MyProject
-└── example.asm // Файл исходного кода на ассемблере
+└── example.asm // Assembly source code file
```
-Содержимое файла "example.asm"
+The contents of the "example.asm" file are as follows:
```asm
ORG 0800h
INIT:
- MVI A, 0Fh ; put value 0F to reg A
- OUT 5 ; send value from A to port 5
+ MVI A, 0Fh ; Load 0F into register A
+ OUT 5 ; Output the value in A to port 5
- IN 5 ; get value from port 5 to reg A
+ IN 5 ; Input from port 5 into register A
XRI 0FFh
CALL SOME_FOO
@@ -57,49 +78,56 @@ SOME_FOO:
CALL 04FCh
RET
-ORG 0900h ; raw data definition
+ORG 0900h ; Raw data definition
DB 5
DB 18
DB 18h
DB 12o
DB 0100_0101b
```
-Тогда, после выполнения команды:
+After running the command:
```
i8080 example.asm -b -w
```
-Будет сгенерировано 2 файла рядом с example.asm:
+Two files will be generated next to "example.asm":
```
MyProject
-├── example.asm // Файл исходного кода на ассемблере
-├── example.i8080asm.bin // Бинарный файл с машинным кодом
-├── example.i8080asm.txt // Файл листинга
-└── example.i8080asm.docx // Файл Word с таблицей листинга
+├── example.asm // Assembly source code file
+├── example.i8080asm.bin // Binary file with machine code
+├── example.i8080asm.txt // Listing file
+└── example.i8080asm.docx // Word file with listing table
```
-Содержимое файла "example.i8080asm.txt"
+The contents of the "example.i8080asm.txt" file are as follows:
```
ADR | MC | LABEL | ASM ; COMMENT
- | | | ORG 0800H ;
-0800 | 3E | INIT: | MVI A,0FH ; PUT VALUE 0F TO REG A
-0801 | 0F | | ;
-0802 | D3 | | OUT 5 ; SEND VALUE FROM A TO PORT 5
-0803 | 05 | | ;
-0804 | DB | | IN 5 ; GET VALUE FROM PORT 5 TO REG A
-0805 | 05 | | ;
-0806 | EE | | XRI 0FFH ;
-0807 | FF | | ;
-0808 | CD | | CALL SOME_FOO ;
-0809 | 0B | | ;
-080A | 08 | | ;
-080B | CD | SOME_FOO: | CALL 04FCH ;
-080C | FC | | ;
-080D | 04 | | ;
-080E | C9 | | RET ;
+ | | | ORG 0800H ;
+0800 | 3E | INIT: | MVI A,0FH ; LOAD 0F INTO REGISTER A
+0801 | 0F | | ;
+0802 | D3 | | OUT 5 ; OUTPUT THE VALUE IN A TO PORT 5
+0803 | 05 | | ;
+0804 | DB | | IN 5 ; INPUT FROM PORT 5 INTO REGISTER A
+0805 | 05 | | ;
+0806 | EE | | XRI 0FFH ;
+0807 | FF | | ;
+0808 | CD | | CALL SOME_FOO ;
+0809 | 0B | | ;
+080A | 08 | | ;
+080B | CD | SOME_FOO: | CALL 04FCH ;
+080C | FC | | ;
+080D | 04 | | ;
+080E | C9 | | RET ;
| | | ORG 0900H ; RAW DATA DEFINITION
-0900 | 05 | | DB 5 ;
-0901 | 12 | | DB 18 ;
-0902 | 18 | | DB 18H ;
-0903 | 0A | | DB 12O ;
-0904 | 45 | | DB 0100_0101B ;
+0900 | 05 | | DB 5 ;
+0901 | 12 | | DB 18 ;
+0902 | 18 | | DB 18H ;
+0903 | 0A | | DB 12O ;
+0904 | 45 | | DB 0100_0101B ;
```
+## Building the Project for All Platforms
+
+To build the project, you need to have .NET 8.0 SDK installed. You can download it from the official [.NET website](https://dotnet.microsoft.com/download/dotnet/8.0). After installing the SDK, you can build the project for all platforms using the following command:
+```
+dotnet publish -c Release -r linux-x64 --self-contained true
+```
+This will generate the executable file "i8080" in the "bin/Release/net8.0/linux-x64/publish" directory. You can use this file on any Linux-based platform. For other platforms, simply replace "linux-x64" with the appropriate runtime identifier.