more ai generated doc with human review

libs/main/client_server/piclientserver_client.h

@@ -35,13 +35,18 @@ namespace PIClientServer {
 
 // ServerClient
 
-//! ~english Server-side client implementation
-//! ~russian Серверная реализация клиента
+//! \details
+//! \~english Server-side client representation. Created and managed by Server. Used to communicate with remote clients connected to the
+//! server.
+//! \~russian Представление клиента на стороне сервера. Создаётся и управляется сервером. Используется для коммуникации с удалёнными
+//! клиентами, подключёнными к серверу.
 class PIP_CLIENT_SERVER_EXPORT ServerClient: public ClientBase {
 	friend class Server;
 	NO_COPY_CLASS(ServerClient);
 
 public:
+	//! \~english Creates empty ServerClient instance
+	//! \~russian Создает пустой экземпляр ServerClient
 	ServerClient() {}
 
 protected:
@@ -56,13 +61,20 @@ private:
 
 // Client
 
-//! ~english Client implementation for connecting to servers
-//! ~russian Клиентская реализация для подключения к серверам
+//! \details
+//! \~english Client implementation for connecting to servers. Provides TCP connection to remote server with diagnostics and packet
+//! streaming support.
+//! \~russian Реализация клиента для подключения к серверам. Обеспечивает TCP-соединение с удалённым сервером с поддержкой диагностики и
+//! потоковой передачи пакетов.
 class PIP_CLIENT_SERVER_EXPORT Client: public ClientBase {
 	NO_COPY_CLASS(Client);
 
 public:
+	//! \~english Creates Client instance
+	//! \~russian Создает экземпляр Client
 	Client();
+	//! \~english Destroys Client instance
+	//! \~russian Уничтожает экземпляр Client
 	~Client();
 
 	//! ~english Connects to specified server address