diff --git a/README.md b/README.md
index c6ce1b2..a077e7b 100644
--- a/README.md
+++ b/README.md
@@ -3,39 +3,42 @@
 ## Description
 Pyladoc is a python package for programmatically generating HTML and
 PDF/LaTeX output. This package targets specifically applications where reports
-or results with Pandas-tables and Matplotlib-figures are generated programmatically
-to be displayed as website and as PDF document without any manual formatting
-steps.
+or results with Pandas-tables and Matplotlib-figures are generated 
+to be displayed as website and as PDF document without involving any manual
+formatting steps.
 
 This package focuses on the "Document in Code" approach for cases
 where a lot of calculations and data handling is done but not a lot of
-document text needs to be displayed.
+document text needs to be displayed. The multiline string capability of Python
+handles this very well. In comparison to "Code in Document"-templates
+python tools supports this approach out of the box.
 
 As backend for PDF generation LaTeX is used. There are excellent engines for
-rendering HTML to PDF available, but even if there is no requirement for an
-accurate typesetting, placing programmatically content of variable
+rendering HTML to PDF, but even if there is no requirement for an
+accurate typesetting and what not, placing programmatically content of variable
 composition and element sizes on fixed size pages without manual intervention
-is a hard problem that LaTeX is very capable of.
+is a hard problem where LaTeX is superior.
 
 ## Example outputs
-The following documents are generated by [tests/test_rendering_example1_doc.py](tests/test_rendering_example1_doc.py):
-
 - HTML: [test_html_render1.html](https://html-preview.github.io/?url=https://github.com/Nonannet/pyladoc/blob/main/tests/out/test_html_render1.html)
 - PDF: [test_latex_render1.pdf](https://raw.githubusercontent.com/Nonannet/pyladoc/refs/heads/main/tests/out/test_latex_render1.pdf)
 
+The documents are generated by the script [tests/test_rendering_example1_doc.py](tests/test_rendering_example1_doc.py).
+
 ### Supported primitives
 - Text (can be Markdown or HTML formatted)
 - Headings
 - Tables (Pandas, Markdown or HTML)
 - Matplotlib figures
-- LaTeX equations (Block or inline)
-- Named references for figures, tables and equation
+- LaTeX equations (block or inline)
+- Named references for figures, tables and equations
 
 ### Key Features
 - HTML and PDF/LaTeX rendering of the same document
 - Single file output including figures
 - Figure and equation embedding in HTML by inline SVG, SVG in Base64 or PNG in Base64
 - Figure embedding in LaTeX as PGF/TikZ
+- Tested on Linux and Windows
 
 ### Usage Scenarios
 - Webservices
@@ -48,6 +51,14 @@ It can be installed with pip:
 pip install pyladoc
 ```
 
+## Dependencies
+Pyladoc depends on the markdown package.
+
+Optional dependencies are:
+- Matplotlib python package for rendering LaTeX equations for HTML output
+- LaTeX for exporting to PDF or exporting Matplotlib figures to LaTeX (PGF/TikZ rendering)
+- Pandas and Matplotlib for including Pandas Tables and Matplotlib figures (obviously)
+
 ## Usage
 It is easy to use as the following example code shows:
 
@@ -116,6 +127,6 @@ Ensure that everything is set up correctly by running the tests:
 ```bash
 pytest
 ```
-   
+
 ## License
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
\ No newline at end of file