docs: enhance README and add contributing guide

CONTRIBUTING.md

@@ -0,0 +1,21 @@
+# Contributing to Werk24 Python Client
+
+We appreciate your interest in improving the Werk24 Python Client!
+
+## Getting Started
+- Fork this repository.
+- Create a feature branch: `git checkout -b feature-name`.
+- Install dependencies: `pip install -r requirements.txt`.
+
+## Testing
+- Ensure all tests run successfully:
+  ```bash
+  pytest
+  ```
+
+## Pull Requests
+- Describe the motivation and impact of your changes.
+- Reference any relevant issues.
+- The team will review your contribution as soon as possible.
+
+Thank you for helping make Werk24 better!

README.md

@@ -1,28 +1,51 @@
-# Werk24 Python Client
-
 <p align="center">
-  <p align="center">
-    <a href="https://werk24.io/?utm_source=github&utm_medium=logo" target="_blank">
-      <img src="https://github.com/W24-Service-GmbH/.github/blob/prod/profile/Werk24_banner_GitHub.png?raw=true" alt="Werk24">
-    </a>
-  </p>
+  <a href="https://werk24.io/?utm_source=github&utm_medium=logo" target="_blank">
+    <img src="https://github.com/W24-Service-GmbH/.github/blob/prod/profile/Werk24_banner_GitHub.png?raw=true" alt="Werk24">
+  </a>
 </p>
 
+# Werk24 Python Client
+
+Unlock manufacturing intelligence from technical drawings with AI.
+
 [![PyPI version](https://img.shields.io/pypi/v/werk24.svg)](https://pypi.python.org/pypi/werk24)
+![Python Version](https://img.shields.io/pypi/pyversions/werk24.svg)
+![License](https://img.shields.io/badge/license-commercial-blue)
+[![Downloads](https://img.shields.io/pypi/dm/werk24.svg)](https://pypi.python.org/pypi/werk24)
 [![Tests](https://github.com/W24-Service-GmbH/werk24-python/actions/workflows/python-test.yml/badge.svg)](https://github.com/W24-Service-GmbH/werk24-python/actions/workflows/python-test.yml)
 
+## Table of Contents
+- [Overview](#overview)
+- [Why Werk24?](#why-werk24)
+- [Features](#features)
+- [Applications](#applications)
+- [Installation](#installation)
+- [Quick Start](#quick-start)
+- [Documentation](#documentation)
+- [Community & Support](#community--support)
+- [Contributing](#contributing)
+- [License](#license)
+
 ## Overview
 
 Werk24 provides AI-powered solutions for extracting and interpreting technical drawings.
 This Python client enables easy interaction with the Werk24 API for processing technical drawings efficiently.
-The API give you access to the following structured data:
+The API gives you access to the following structured data:
 
 - **Meta Data**: Drawing ID, Part ID, Designation, General Tolerances, General Roughness, Material, Weight, Bill of Material, Revision Table, Languages and Notes.
-- **Features**: Dimensions incl. Tolerances, Threads, Bores, Chamfers, Roughnesses, GDnTs, Radii
-- **Insights**: Manufacturing Method, Postprocesses, Input Geometry, Output Geometry
+- **Features**: Dimensions incl. Tolerances, Threads, Bores, Chamfers, Roughnesses, GDnTs, Radii.
+- **Insights**: Manufacturing Method, Postprocesses, Input Geometry, Output Geometry.
 - **Redaction**: Redact information from Technical Drawings.
 
-Check our website at [https://werk24.io](https://werk24.io/?utm_source=github&utm_medium=feature_link).
+👉 Visit [werk24.io](https://werk24.io/?utm_source=github&utm_medium=feature_link) to learn more or request a demo.
+
+## Why Werk24?
+
+- **Accelerate Quoting** – Generate prices from 2D drawings in seconds.
+- **Reduce Manual Entry** – Automatically capture metadata and dimensions.
+- **Speed Up Supplier Scouting** – Match drawings with capable vendors.
+- **Protect IP** – Anonymize sensitive details before sharing.
+- **Boost Productivity** – Let engineers focus on design, not data extraction.
 
 ## Features
 
@@ -94,3 +117,26 @@ $> werk24 --help
 ╰───────────────────────────────────────────────────────────────────────────────────────────╯
 
 ```
+
+## Community & Support
+
+- Website: [werk24.io](https://werk24.io/?utm_source=github&utm_medium=community_link)
+- Email: [info@werk24.io](mailto:info@werk24.io)
+- LinkedIn: [Werk24](https://www.linkedin.com/company/werk24/)
+
+Have questions? [Request a demo](https://werk24.io/?utm_source=github&utm_medium=request_demo) or open an issue and we’ll be happy to help.
+
+## Contributing
+
+We welcome contributions that improve the client or documentation.
+
+1. Fork the repository and create a new branch.
+2. Make your changes and ensure tests pass with `pytest`.
+3. Open a pull request describing your changes.
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for more details.
+
+## License
+
+The Werk24 Python Client requires a commercial Werk24 license to use.
+See [LICENSE.txt](LICENSE.txt) for terms and conditions.