docs: standardize Doxyfile and README for vcpkg deployment (#431)

* docs: standardize Doxyfile and README for vcpkg deployment

- Set TIMESTAMP=NO for reproducible builds
- Add QT_AUTOBRIEF=NO, WARN_IF_INCOMPLETE_DOC=YES
- Add *.md to FILE_PATTERNS
- Remove redundant mainpage.dox from INPUT
- Add missing HTML settings (COLORSTYLE, CODE_FOLDING, SIDEBAR)
- Standardize EXCLUDE_PATTERNS
- Add vcpkg install instructions to README Quick Start

Closes #430

* docs(headers): add @code usage example to main public header

Relates to #430

Author: kcenon

Doxyfile

@@ -23,6 +23,7 @@ INLINE_INHERITED_MEMB  = NO
 FULL_PATH_NAMES        = YES
 SHORT_NAMES            = NO
 JAVADOC_AUTOBRIEF      = NO
+QT_AUTOBRIEF           = NO
 MULTILINE_CPP_IS_BRIEF = YES
 INHERIT_DOCS           = YES
 SEPARATE_MEMBER_PAGES  = NO
@@ -46,7 +47,7 @@ INLINE_SIMPLE_STRUCTS  = NO
 TYPEDEF_HIDES_STRUCT   = NO
 LOOKUP_CACHE_SIZE      = 0
 NUM_PROC_THREADS       = 1
-TIMESTAMP              = YES
+TIMESTAMP              = NO
 EXTRACT_ALL            = YES
 EXTRACT_PRIVATE        = YES
 EXTRACT_STATIC         = YES
@@ -89,15 +90,15 @@ WARN_IF_UNDOCUMENTED   = YES
 WARN_IF_DOC_ERROR      = YES
 WARN_NO_PARAMDOC       = YES
 WARN_AS_ERROR          = NO
+WARN_IF_INCOMPLETE_DOC = YES
 WARN_FORMAT            = "$file:$line: $text"
 WARN_LOGFILE           =
 INPUT                  = ./core \
                          ./values \
                          ./internal \
                          ./integration \
                          ./examples \
-                         ./utilities \
-                         ./mainpage.dox
+                         ./utilities
 
 INPUT_ENCODING         = UTF-8
 FILE_PATTERNS          = *.c \
@@ -108,7 +109,8 @@ FILE_PATTERNS          = *.c \
                          *.hh \
                          *.hpp \
                          *.tpp \
-                         *.cppm
+                         *.cppm \
+                         *.md
 
 RECURSIVE              = YES
 EXCLUDE                = build \
@@ -120,6 +122,8 @@ EXCLUDE_SYMLINKS       = NO
 EXCLUDE_PATTERNS       = */build/* \
                          */vcpkg/* \
                          */.git/* \
+                         */_deps/* \
+                         */node_modules/* \
                          */.*
 
 EXCLUDE_SYMBOLS        =
@@ -160,6 +164,9 @@ HTML_EXTRA_FILES       =
 HTML_COLORSTYLE_HUE    = 220
 HTML_COLORSTYLE_SAT    = 100
 HTML_COLORSTYLE_GAMMA  = 80
+HTML_COLORSTYLE        = AUTO_LIGHT
+HTML_CODE_FOLDING      = YES
+FULL_SIDEBAR           = NO
 HTML_TIMESTAMP         = NO
 HTML_DYNAMIC_MENUS     = YES
 HTML_DYNAMIC_SECTIONS  = NO

README.md

@@ -75,6 +75,18 @@ messaging_system, network_system, database_system
 
 ## Quick Start
 
+### Installation via vcpkg
+
+```bash
+vcpkg install kcenon-container-system
+```
+
+In your `CMakeLists.txt`:
+```cmake
+find_package(container_system CONFIG REQUIRED)
+target_link_libraries(your_target PRIVATE kcenon::container_system)
+```
+
 ### Basic Usage Example
 
 ```cpp

include/container/optimizations/fast_parser.h

@@ -32,6 +32,16 @@
 /**
  * @file fast_parser.h
  * @brief Fast-path parsing utilities and configuration for the container system.
+ *
+ * @code
+ * // Configure the fast parser and reserve container capacity
+ * kcenon::container::parser_config config;
+ * config.use_fast_path = true;
+ * config.initial_capacity = 1024;
+ *
+ * std::vector<int> data;
+ * kcenon::container::reserve_if_possible(data, config.initial_capacity);
+ * @endcode
  */
 
 namespace kcenon::container {