add readme fix up

README.md

@@ -6,23 +6,36 @@ In the current setup, this repository is integrated into the main `mars_nwe` pro
 
 ## Screenshots
 
-The screenshots below use anonymized demo data. Exact paths, usernames, printer names, and build placeholders may differ on a real installation.
+The main menu is the normal entry point after login. It shows the available
+configuration sections on the left and opens the selected explanation or editor
+view on the right.
 
-| Login | Service runtime page |
-| --- | --- |
-| ![SMArT login screen](doc/screenshots/login.png) | ![SMArT service runtime page](doc/screenshots/service-runtime.png) |
+![SMArT main menu](doc/screenshots/main-menu.png)
 
-| Main menu and advanced section | Volume import from local mount points |
-| --- | --- |
-| ![SMArT main menu with an advanced section opened](doc/screenshots/main-menu-advanced.png) | ![SMArT volume page with local mount point import](doc/screenshots/volumes-import.png) |
+Additional UI examples:
 
-| User editor | Print queue editor with CUPS helper |
-| --- | --- |
-| ![SMArT user editor](doc/screenshots/user-editor.png) | ![SMArT print queue editor with CUPS helper](doc/screenshots/print-queue-cups.png) |
-
-| Validation error page |
-| --- |
-| ![SMArT validation error page](doc/screenshots/validation-error.png) |
+<table>
+<tr>
+<td width="50%"><a href="doc/screenshots/login.png"><img src="doc/screenshots/thumbs/login.png" alt="Login screen"></a><br><strong>Login</strong><br>PAM-based login with SMArT session cookies.</td>
+<td width="50%"><a href="doc/screenshots/service-runtime.png"><img src="doc/screenshots/thumbs/service-runtime.png" alt="Runtime information"></a><br><strong>Runtime information</strong><br>Configured paths, service name and project link.</td>
+</tr>
+<tr>
+<td width="50%"><a href="doc/screenshots/volumes-import.png"><img src="doc/screenshots/thumbs/volumes-import.png" alt="Volume import"></a><br><strong>Volume import</strong><br>Detected host mountpoints can be imported as MARS_NWE volumes.</td>
+<td width="50%"><a href="doc/screenshots/user-editor.png"><img src="doc/screenshots/thumbs/user-editor.png" alt="User editor"></a><br><strong>User editor</strong><br>Optional Unix user mapping and bindery group membership.</td>
+</tr>
+<tr>
+<td width="50%"><a href="doc/screenshots/print-queue-cups.png"><img src="doc/screenshots/thumbs/print-queue-cups.png" alt="Print queue CUPS integration"></a><br><strong>Print queues</strong><br>CUPS printer selection can prefill the Unix print command.</td>
+<td width="50%"><a href="doc/screenshots/smart-settings.png"><img src="doc/screenshots/thumbs/smart-settings.png" alt="SMArT settings"></a><br><strong>SMArT settings</strong><br>Bindery server settings and server-name synchronization.</td>
+</tr>
+<tr>
+<td width="50%"><a href="doc/screenshots/general-settings.png"><img src="doc/screenshots/thumbs/general-settings.png" alt="General settings"></a><br><strong>General settings</strong><br>Core MARS_NWE options with synchronized bindery naming.</td>
+<td width="50%"><a href="doc/screenshots/advanced-path-settings.png"><img src="doc/screenshots/thumbs/advanced-path-settings.png" alt="Advanced path settings"></a><br><strong>Advanced sections</strong><br>Only the matching advanced section is displayed for the selected menu item.</td>
+</tr>
+<tr>
+<td width="50%"><a href="doc/screenshots/validation-error.png"><img src="doc/screenshots/thumbs/validation-error.png" alt="Validation error"></a><br><strong>Validation errors</strong><br>Invalid input is rejected with a focused error page and a back action.</td>
+<td width="50%"><a href="doc/screenshots/service-control.png"><img src="doc/screenshots/thumbs/service-control.png" alt="Service control output"></a><br><strong>Service control</strong><br>Start, stop, restart and status output for the configured MARS_NWE service.</td>
+</tr>
+</table>
 
 ## Project status and integration
 
@@ -315,6 +328,24 @@ $nw_cert_file  = '/etc/mars_nwe/server.crt';
 $nw_key_file   = '/etc/mars_nwe/server.key';
 ```
 
+## Recent SMArT WebUI features
+
+The current WebUI includes several usability and safety improvements:
+
+- HTML login, session cookies and logout handling
+- static asset serving before login, so the login page can load the SMArT logo
+- service-control pages for start, stop, restart and status actions
+- runtime information on the start page, including generated paths and service name
+- import helpers for CUPS printers, IPX interfaces, Unix users and local mountpoints
+- input validation pages for volumes, devices, print queues, users and groups
+- stricter bindery object-name validation
+- optional Unix user mapping for bindery users
+- delete confirmation pages
+- bindery command and bindery pipe logging
+- success and error pages for bindery operations
+- a `UNIX_USER` guard so existing users are not remapped unless requested
+- configurable Perl log verbosity through `$smart_debug_level`
+
 ## Build and installation notes
 
 This repository is built as part of the main `mars_nwe` build. The build system: