Updated Readme content (#685)

Author: olganaumenko

README.md

@@ -1,32 +1,91 @@
 [![UTBot Java: build and run tests](https://github.com/UnitTestBot/UTBotJava/actions/workflows/build-and-run-tests.yml/badge.svg)](https://github.com/UnitTestBot/UTBotJava/actions/workflows/build-and-run-tests.yml)
 [![Plugin and CLI: publish as archives](https://github.com/UnitTestBot/UTBotJava/actions/workflows/publish-plugin-and-cli.yml/badge.svg)](https://github.com/UnitTestBot/UTBotJava/actions/workflows/publish-plugin-and-cli.yml)
 
-Install the [IntelliJ IDEA Plugin](https://plugins.jetbrains.com/plugin/19445-unittestbot).
+👉 Find UTBot Java on [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/19445-unittestbot).
 
-Visit the official [UTBot ](https://www.utbot.org/)website.
+👉 Visit the [official UTBot website](https://www.utbot.org/).
 
-# What is UTBotJava?
+# What is UTBot Java?
+UTBot Java is the tool for **automated unit test generation**. It produces ready-to-use test cases for Java — with valid inputs and comments. It can even predict whether the tests fail or pass. You can analyze them, run them, show coverage — as if you've created them personally.
 
-UTBotJava generates test cases by code, trying to cover maximum statements and execution paths. We treat source code as source of truth assuming that behavior is correct and corresponds to initial user demand. Generated tests are placed in so-called regression suite. Thus, we fixate current behavior by generated test cases. Using UTBotJava developers obtain full control of their code. No future change can break the code without being noticed once it's covered with tests generated by UTBot. This way, modifications made by developers to an existing code are much safer. Hence, with the help of generated unit tests, UTBot provides dramatic code quality improvement.
+The **symbolic execution engine** paired with a **smart fuzzing technique** constitutes the core of UTBot Java. It helps to **find errors** and **prevent regressions** in the code in a much more efficient way — UTBot Java **maximizes path coverage** while **minimizing the number of tests and false positives**.
 
-# UTBot Java IntelliJ IDEA plugin
+UTBot Java represents all the test summaries in a **human-readable format**. The intelligible test method names and comments help you to control the whole testing process. Test failed? The summary refers you to the related branch or the condition under test.
 
-UTBot Java provides users with **IntelliJ IDEA** plugin. 
+# Get started
+Try the **[online demo](https://www.utbot.org/utbot/)** to generate unit tests with one click.
 
-_The plugin was tested on **Win64**, **Linux64** and **MacOSx86_64**._
+Get to know the **full version** of UTBot Java plugin with this quick guide:
 
-# How to download IntelliJ IDEA plugin
+<details>
+  <summary>Install UTBot Java plugin for IntelliJ IDEA</summary>
 
-You can download the plugin from [GitHub Releases](https://github.com/UnitTestBot/UTBotJava/releases).
+Try the most straightforward path to start using UTBot plugin.
+1. Open your IntelliJ IDEA. If you don't have one, get it from [JetBrains](https://www.jetbrains.com/idea/download/#section=windows).
+2. Go to **File → Settings... → Plugins → Marketplace**.
+3. In the search field type *UTBot* — you'll see the UnitTestBot plugin page.
+4. Press the **Install** button and wait until it changes to **Installed**, then click **OK**.
 
-# How to install IntelliJ IDEA plugin
+Now you can find the UTBot plugin enabled in the **File → Settings → Plugins** window.
 
-See [step-by-step guide](https://github.com/UnitTestBot/UTBotJava/wiki/intellij-idea-plugin) explaining how to install the plugin.
+____________
+</details>
 
-# How to use IntelliJ IDEA plugin
+<details>
+  <summary>Generate tests with default configuration</summary>
 
-See [step-by-step guide](https://github.com/UnitTestBot/UTBotJava/wiki/generate-tests-with-plugin) explaining how to use the plugin.
+Proceed to generating unit tests for the existing Java project. If you don't have one, create it using the [JetBrains tutorial](https://www.jetbrains.com/help/idea/creating-and-running-your-first-java-application.html).
 
-# How to contribute to UTBot Java
+1. Open your Java project in IntelliJ IDEA. 
+2. Right-click the required package or a file in the Project tool window, scroll the menu down to the bottom and choose **Create Tests with UTBot...**
+3. In the **Generate tests with UTBot** window tick the classes or methods you'd like to cover with unit tests and press **OK**.
 
-See [**Contributing guidelines**](CONTRIBUTING.md).
+Now you can see the resulting test class or classes in the Editor tool window.
+
+____________
+</details>
+
+<details>
+  <summary>Make use of generated tests</summary>
+
+What can you do with the output?
+
+1. To *find and fix the errors* in your code:
+
+* Run the generated tests: right-click the test class or a folder with tests and choose **Run**.
+
+* In the Run tool window you can see the tests failed with the brief failure explanation.
+
+* Fix your errors if needed.
+
+2. To *prevent regressions*:
+
+* Having your errors fixed, run the tests again. "Passed"? Commit them as the regression suite.
+
+* Introduce changes in the code and run your tests as often as needed!
+
+* Tests failed? Decide whether it is a bug or a feature and generate new tests if necessary.
+
+3. To *view coverage*:
+
+Right-click the test class, choose **More Run/Debug → Run ... with Coverage**.
+
+____________
+</details>
+
+# Contribute to UTBot Java
+UTBot Java is an open source project. We welcome everyone who wants to make UTBot Java better — introduce a new feature or report a bug. We have only one kind request for our contributors: we expect you to prove the necessity and quality of the suggested changes.
+
+How can you do this? Refer to our [Contributing guide](https://github.com/UnitTestBot/UTBotJava/blob/main/CONTRIBUTING.md).
+
+Feel free to join the [Discussions](https://github.com/UnitTestBot/UTBotJava/discussions)!
+
+And thank you for your time and effort! ⭐
+
+# Find support
+Having troubles with using UTBot Java? Contact us [directly](https://www.utbot.org/contact).
+
+# Find more UTBot products
+[UTBot Cpp](https://github.com/UnitTestBot/UTBotCpp) — try it yourself and tell your friends: it is the tool for automated unit test generation developed especially for C/C++.
+
+You are welcome to [contribute](https://github.com/UnitTestBot/UTBotCpp/blob/main/CONTRIBUTING.md) to it too!