update readme documentation and screenshots

README.md

@@ -1,107 +1,124 @@
 # dev-tools ![Build](https://github.com/reugn/dev-tools/workflows/Build/badge.svg)
 
-Widely used software developer tools in a single application.
-* [Json Editor](#json_editor)
-* [UUID/Password Generator](#generator)
-* [Hash Calculator](#hash_calculator)
-* [Epoch Converter](#epoch_converter)
-* [Regular Expression Tester](#regex)
-* [Rest API Tester](#rest_api)
-* [ASCII Graphics](#ascii)
-* [Logs Generator](#logs)
+A collection of developer utilities in a single desktop application.
+
+* [JSON Editor](#json-editor)
+* [Image Editor](#image-editor)
+* [Rest API Tester](#rest-api-tester)
+* [JWT Decoder](#jwt-decoder)
+* [UUID/Password Generator](#uuid-password-generator)
+* [Hash Calculator](#hash-calculator)
+* [Epoch Converter](#epoch-converter)
+* [Regular Expression Tester](#regular-expression-tester)
+* [ASCII Graphics](#ascii-graphics)
+* [Log Generator](#log-generator)
 
 ## Installation
-* `dev-tools` is a [JavaFX](https://openjfx.io/) Maven application.
-Build an executable jar from the source.
+
+`dev-tools` is a [JavaFX](https://openjfx.io/) desktop application built with Maven.
+Obtain a binary using one of the following methods:
+
+* Build an executable jar from the source.
+
 ```
-mvn clean package -U
+./mvnw clean package
 ```
 
-* Build a native application using the [GluonFX Maven plugin](https://github.com/gluonhq/gluonfx-maven-plugin).
-[GraalVM](https://www.graalvm.org/) installation is required.
+* Build a native application using [GluonFX Maven plugin](https://github.com/gluonhq/gluonfx-maven-plugin).
+  [GraalVM](https://www.graalvm.org/) installation is required. After obtaining the GraalVM distribution, the
+  environment variable `GRAALVM_HOME` should be set to point to it.
+
 ```
-mvn clean gluonfx:build
+./mvnw clean gluonfx:build
 ```
 
-* Download a build from the [releases](https://github.com/reugn/dev-tools/releases).
+* Download a build from [releases](https://github.com/reugn/dev-tools/releases).
 
 ## Prerequisites
-* Java 11 (JavaFX is not a part of Java SDK as of JDK 11).
 
-## Features
-* Dark/Light mode.
+* Java 11 or later
 
-## Tools List
+## Getting Started
 
-<a name="json_editor"/>
+* Launch the application. For the executable jar use `java -jar target/dev-tools-<version>.jar`.
+* Explore the main menu and its options.
+* Select a tool from the `Tools` dropdown menu. See below for a complete list with screenshots.
+* Switch between light and dark themes using the `View -> Theme` menu option.
+* Utilize keyboard shortcuts for faster navigation.
 
-### Json Editor
-* JSON pretty print with highlighting.
-* JSON validation.
-* Search Bar (Ctrl+F).
+## Tool List
+
+### JSON Editor
+
+Edit and analyze JSON using syntax highlighting, formatting, and validation.
+Use the built-in search (Ctrl+F) to find items. Navigate between documents using the multi-tab interface.
 
 ![](docs/images/json_editor.png)
 
-<a name="generator"/>
+### Image Editor
 
-### UUID/Password Generator
-* UUID Generator.
-* Password Generator.
+This tool incorporates an essential suite of functions for creating and editing images.
 
-![](docs/images/generator.png)
+![](docs/images/image_editor.png)
 
-<a name="hash_calculator"/>
+### Rest API Tester
 
-### Hash Calculator
-* Hash functions.
-* URL Encode/Decode.
-* Base64 Encode/Decode.
+This tool provides a core set of functionalities for REST API testing.
+Manage and share your testing process via the export and import of HTTP request history.
+Access history features by Ctrl-clicking the history pane. Navigate between requests using the multi-tab interface.
 
-![](docs/images/hash_calculator.png)
+![](docs/images/rest_api.png)
 
-<a name="epoch_converter"/>
+### JWT Decoder
 
-### Epoch Converter
-* Current Unix epoch time.
-* Timestamp to human date.
-* Human date to timestamp.
+Paste your JSON Web Token (JWT) into the input area to decode it. Use the provided buttons to
+decode, encode, and verify the JWT signature. For signature verification, select the correct algorithm and provide
+the necessary secrets.
 
-![](docs/images/epoch_converter.png)
+![](docs/images/jwt_decoder.png)
 
-<a name="regex"/>
+### UUID-Password Generator
 
-### Regular Expression Tester
-* Regex flags.
-* Capturing groups.
+Generate a series of UUIDs (Universally Unique Identifiers) or passwords according to the provided configuration
+controls.
 
-![](docs/images/regex.png)
+![](docs/images/generator.png)
 
-<a name="rest_api"/>
+### Hash Calculator
 
-### Rest API Tester
-* Rest API testing client.
-* Export/import HTTP request history.
+This utility performs cryptographic hashing and various encoding/decoding operations on input data.
 
-![](docs/images/rest_api.png)
+![](docs/images/hash_calculator.png)
+
+### Epoch Converter
 
-<a name="ascii"/>
+Epoch Converter is a utility for converting between Unix epoch time (seconds since January 1, 1970, 00:00:00 UTC)
+and human-readable dates. Features include displaying the current Unix epoch, timestamp to date/time
+conversion, and date/time to timestamp conversion.
+
+![](docs/images/epoch_converter.png)
+
+### Regular Expression Tester
+
+Regular Expression Tester is a tool for testing and debugging regular expressions (regex) featuring full regex flag
+support (i, m, u, etc.), comprehensive capturing group visualization and match highlighting.
+
+![](docs/images/regex_tester.png)
 
 ### ASCII Graphics
-* Convert text to ASCII art.
 
-![](docs/images/ascii.png)
+Easily turn your text into ASCII art. Customize the look with adjustable settings.
 
-<a name="logs"/>
+![](docs/images/ascii_graphics.png)
 
-### Logs Generator
-* Generate fake log workloads using a specified format.
-* Write to console.
-* Write to file.
+### Log Generator
 
-![](docs/images/logs.png)
+Log Generator creates customizable synthetic log data for testing and development.
+Choose from a selection of pre-defined standard log formats.
+Write the generated logs directly to the output pane, or save them to a file for later use.
 
-## Contributing
-If you find this project useful and want to contribute, please open an issue or create a PR.
+![](docs/images/log_generator.png)
 
 ## License
-Licensed under the Apache 2.0 License.
+
+Licensed under the Apache 2.0 license.