diff --git a/README.md b/README.md
index 4aed9e73b..8fb9a98cc 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,7 @@
-
-
Concrete Numpy
-
+
+
+ 
+
@@ -9,11 +10,11 @@
- 
+ 
- 
+ 
@@ -25,14 +26,6 @@
-## Table of contents
-
-- [Introduction](#Introduction)
-- [Installation](#Installation)
-- [Getting started](#getting-started)
-- [License](#license)
-
-## Introduction
**Concrete Numpy** is an open-source library which simplifies the use of fully homomorphic encryption (FHE).
@@ -40,9 +33,26 @@ FHE is a powerful cryptographic tool, which allows computation to be performed d
With FHE, you can build services that preserve the privacy of the users. FHE is also great against data breaches as everything is done on encrypted data. Even if the server is compromised, in the end no sensitive data is leaked.
-## Installation
+## Main features.
-The preferred way to install concrete-numpy is through PyPI. To install Concrete Numpy from PyPi, run the following:
+- Ability to compile Python functions (that may use NumPy within) to their FHE equivalents, to operate on encrypted data
+- Support for [large collection of operators](https://docs.zama.ai/concrete-numpy/getting-started/compatibility)
+- Partial support for floating points
+- Support for table lookups on integers
+- Support for integration with Client / Server architectures
+
+## Installation.
+
+| OS / HW | Available on Docker | Available on PyPI |
+| :----------------------------------: | :-----------------: | :--------------: |
+| Linux | Yes | Yes |
+| Windows | Yes | Coming soon |
+| Windows Subsystem for Linux | Yes | Yes |
+| macOS (Intel) | Yes | Yes |
+| macOS (Apple Silicon, ie M1, M2 etc) | Yes (Rosetta) | Coming soon |
+
+
+The preferred way to install Concrete Numpy is through PyPI:
```shell
pip install concrete-numpy
@@ -56,7 +66,7 @@ docker pull zamafhe/concrete-numpy:v0.9.0
You can find more detailed installation instructions in [installing.md](docs/getting-started/installing.md)
-## Getting started
+## Getting started.
```python
import concrete.numpy as cnp
@@ -96,6 +106,35 @@ for example in examples:
print(f"Evaluation of {' + '.join(map(str, example))} homomorphically = {result}")
```
-## License
+## Documentation.
+
+Full, comprehensive documentation is available at [https://docs.zama.ai/concrete-numpy](https://docs.zama.ai/concrete-numpy).
+
+## Target audience.
+
+Concrete Numpy is a generic library that supports variety of use cases. Because of this flexibility,
+it doesn't provide primitives for specific use cases.
+
+If you have a specific use case, or a specific field of computation, you may want to build abstractions on top of Concrete Numpy.
+
+One such example is [Concrete ML](https://github.com/zama-ai/concrete-ml), which is built on top of Concrete Numpy to simplify Machine Learning oriented use cases.
+
+## Tutorials.
+
+Various tutorials are proposed in the documentation to help you start writing homomorphic programs:
+
+- How to use Concrete Numpy with [Decorators](https://docs.zama.ai/concrete-numpy/tutorials/decorator)
+- Partial support of [Floating Points](https://docs.zama.ai/concrete-numpy/tutorials/floating_points)
+- How to perform [Table Lookup](https://docs.zama.ai/concrete-numpy/tutorials/table_lookup)
+
+More generally, if you have built awesome projects using Concrete Numpy, feel free to let us know and we'll link to it!
+
+## Need support?
+
+
+ 
+
+
+## License.
This software is distributed under the BSD-3-Clause-Clear license. If you have any questions, please contact us at hello@zama.ai.
diff --git a/docs/README.md b/docs/README.md
index 995f4617b..626bd77fa 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -19,6 +19,3 @@ This documentation is split into several sections:
* **How to** section to help you perform specific tasks
* **Developer** section to explain the inner workings of the library and everything related to contributing to the project
-## Looking for support? Ask our team!
-
-
diff --git a/docs/tutorial/extensions.md b/docs/tutorial/extensions.md
index 154b1f15b..0b1868053 100644
--- a/docs/tutorial/extensions.md
+++ b/docs/tutorial/extensions.md
@@ -1,6 +1,6 @@
# Extensions
-**Concrete Numpy** tries to support **NumPy** as much as possible, but due to some technical limitations, not everything can be supported. On top of that, there are some things **NumPy** lack, which are useful. In some of these situations, we provide extesions in **Concrete Numpy** to improve your experience.
+**Concrete Numpy** tries to support **NumPy** as much as possible, but due to some technical limitations, not everything can be supported. On top of that, there are some things **NumPy** lack, which are useful. In some of these situations, we provide extensions in **Concrete Numpy** to improve your experience.
## cnp.zero()