Improve docs for release

README.md

@@ -24,32 +24,46 @@ $ pip3 install .
 ```
 
 Using pip:
-
 ```
 $ pip3 install attackmate
 ```
 
+Using uv:
+```
+$ git clone https://github.com/ait-aecid/attackmate.git
+$ cd attackmate
+$ uv sync
+```
+
 ## Execute
 
+With pip:
 ```
 $ attackmate playbook.yml
 ```
 
+With uv:
+```
+$ uv run attackmate playbook.yml
+```
+
 ![AttackMate Demo](docs/source/images/Demo.gif "AttackMate Demo")
 
 ## Documentation
 
-Please take a look at our documentation for how to install and use attackmate:
+Please take a look at our documentation on how to install and use attackmate:
 
 * [Installation](https://ait-testbed.github.io/attackmate/main/installation/index.html)
 * [Documentation](https://ait-testbed.github.io/attackmate/main/index.html)
 * [Command Reference](https://ait-testbed.github.io/attackmate/main/playbook/commands/index.html)
 * [Example Playbooks](https://ait-testbed.github.io/attackmate/main/playbook/examples.html)
-* [Arxiv Paper](https://arxiv.org/pdf/2601.14108)
+
+## Publications
+* [AttackMate: Realistic Emulation and Automation of Cyber Attack Scenarios Across the Kill Chain](https://arxiv.org/pdf/2601.14108) on Arxiv
 
 ## Contribution
 
-We're happily taking patches and other contributions. Please see the following links for how to get started:
+We're happily taking patches and other contributions. Please see the following links on how to get started:
 
 - [Contribution Guide](https://ait-testbed.github.io/attackmate/main/developing/contribution.html)
 
@@ -64,13 +78,12 @@ information may result in criminal charges.
 
 ## Security
 
-AttackMate should only be executed against own test or training systems.
-For this reason, every software bug is treated equally, regardless of
-whether it is security relevant or not.
+AttackMate should only be executed against systems you own or have explicit permission to test.
+For this reason, all software bugs are treated with equal priority, regardless of whether they have security implications.
 
 *Please note that AttackMate could easily be executed in a dangerous way. For example, by
 parsing the RESULT_STDOUT of a malicious server. The server response could lead to
-a command injection. Keep that in mind!
+a command injection. Keep that in mind and always treat external input with caution!
 
 ## License
 

docs/source/about.rst

@@ -2,6 +2,6 @@
 About
 =====
 
-AttackMate is a command line tool that can perform entire attack chains based on playbooks. It can be used for cybersecurity training as well as for testing detection engines. AttackMate is so designed that any part of an attack can be easily replaced or varied. Furthermore, the playbooks enable the portability and reproducibility of attack chains. A key focus was on user-friendliness and flexibility for attack chain designers.
+AttackMate is a command-line tool that executes full attack chains defined in playbooks. It is designed for cybersecurity training, red team exercises, and testing detection engines. Individual attack steps can be freely replaced or varied, and playbooks ensure that attack chains are portable and reproducible. A key focus was on user-friendliness and flexibility for attack chain designers.
 
 .. image:: images/Demo.gif