docs: update&improve docs

Author: alexeev-dev

README.md

@@ -125,6 +125,7 @@ Check other our projects:
 ## Project Architecture
 
 ```
+.
 ├── build.sh
 ├── CHANGELOG.md
 ├── cmake
@@ -146,7 +147,6 @@ Check other our projects:
 ├── CMakePresets.json
 ├── CMakeUserPresets.json
 ├── conanfile.py
-├── cwpLvF9U
 ├── docs
 │   ├── doxygen-styles.css
 │   ├── en

docs/README.md

@@ -1,4 +1,4 @@
-@mainfile
+@mainpage
 # libnumerixpp
 
 <p align="center">A Powerful C++ Library for High-Performance Numerical Computing</p>
@@ -15,15 +15,14 @@
 > [!CAUTION]
 > At the moment, libnumerixpp is under active development (alpha), many things may not work, and this version is not recommended for use (all at your own risk).
 
-> [!CAUTION]
-> libnumerixpp in development (alpha), many things may not work, and this version is not recommended for use (all at your own risk).
-
 libnumerixpp is a powerful, cross-platofrm C++ library designed for high-performance numerical computing in the domains of physics, mathematics, and computer science.
 
 You can join to our [small russian telegram blog](https://t.me/hex_warehouse).
 
  > You can view docs for libnumerixpp [here](https://alexeev-prog.github.io/libnumerixpp).
 
+ > Current version: 0.1.2
+
 ## Key Features
  - **Extensive Functionality**: libnumerixpp provides a wide range of functions coverint the core areas of mathematics, physics, and computer science, including:
   - Mathematics: linear algebra, calculus, geometry
@@ -127,6 +126,7 @@ Check other our projects:
 ## Project Architecture
 
 ```
+.
 ├── build.sh
 ├── CHANGELOG.md
 ├── cmake
@@ -148,7 +148,6 @@ Check other our projects:
 ├── CMakePresets.json
 ├── CMakeUserPresets.json
 ├── conanfile.py
-├── cwpLvF9U
 ├── docs
 │   ├── doxygen-styles.css
 │   ├── en

docs/ru/article3.md

@@ -0,0 +1,40 @@
+# Создаем и улучшаем нашу библиотеку на C++ с CMake, тестами, документацией и блекджеком: часть 3
+В мире программирования создание собственных библиотек - это не просто возможность пополнения своего портфолио или способ структурировать код, а настоящий акт творческого самовыражения (и иногда велосипедостроения). Каждый разработчик иногда использовал в нескольких своих проектах однообразный код, который приходилось каждый раз перемещать. Да и хотя-бы как упаковать свои идеи и знания в удобный и доступный формат, которым можно будет поделиться с сообществом.
+
+Если вы ловили себя на мысли: "А почему мне бы не создать свою полноценную библиотеку?", то я рекомендую прочитать вам мою статью.
+
+Эту статью вы можете использовать как шпаргалку для создания проектов, и не только библиотек.
+
+Некоторые из вас могут подумать что мы изобретаем велосипед. А я в ответ скажу - сможете ли вы прямо сейчас, без подсказок, только по памяти, нарисовать велосипед без ошибок?
+
+Добро пожаловать в третью, скорее всего финальную (наверное) часть статьи! Здесь мы окончательно допишем код, исправим некоторые ошибки.
+
+Первая часть доступна по [этой ссылке](https://habr.com/ru/companies/timeweb/articles/845074/), вторая часть доступна по [другой ссылке](https://habr.com/ru/companies/timeweb/articles/846736/).
+
+---
+
+Итак, в прошлых двух статьях мы сделали:
+
+ + Автоматическую генерацию документации с ее публикацией на GitHub Pages
+ + Продвинутую сборку при помощи CMake
+ + Инструменты для форматирования и линтинга кода
+
+В этой статье мы будем работать над архитектурной частью, над библиотекой, улучшим ее аспекты, и конечно-же, продолжим писать C++ код.
+
+# Внешний вид библиотеки
+Человека встречают по одежке, а open source проект - по его описанию, README. Для того, чтобы пользователь мог понять, что к чему, следует в описании отвечать на следующие вопросы:
+
+Какое назначение проекта? Описание должно быть лаконичным и отражающим суть проекта.
+
+Почему проект полезен? Он должен решать определенные проблемы, поэтому необходимо явно написать о них, чтобы потенциальный пользователь мог понять, будет ли библиотека полезной для него. Нужно выделить преимущества своего решения по сравнению с аналогами, желательно с конкретными цифрами и бенчмарками, иначе потенциальный пользователь установит более эффективную или популярную библиотеку.
+
+Как приступить к работе с библиотекой? Этап с установкой и настройкой библиотеки необходимо описать самым детальным образом. Ведь далеко не всегда то, что очевидно вам — очевидно другим. Решением могут пользоваться люди, у которых совершенно другой опыт. Нужно, чтобы любой желающий, кто хочет установить решение, понял, как это сделать.
+
+Где можно получить дополнительную помощь, если она мне понадобится? Обязательно оставить свои контакты или другую предпочитаемую форму взаимодействия.
+
+Можно использовать свой README для ответа на другие вопросы. Например, дальнейшие цели в развитии проекта, информация о лицензиях, важных изменениях в коде.
+
+## Содержание
+
+ + [Первая часть](https://habr.com/ru/companies/timeweb/articles/845074/)
+ + [Вторая часть]((https://habr.com/ru/companies/timeweb/articles/846736/)

docs/ru/index.md

@@ -1,3 +1,5 @@
 # libnumerixpp Russian Docs
 
  + [Создаем свою C++ библиотеку с документацией, CMake и блекджеком](./article.md)
+ + [Создаем свою C++ библиотеку с документацией, CMake и блекджеком: часть 2](./article2.md)
+ + [Создаем свою C++ библиотеку с документацией, CMake и блекджеком: часть 3](./article3.md)