docs: improve module docstrings

concrete/__init__.py

@@ -1,5 +1,5 @@
 """
-Declaration of `concrete` namespace.
+Setup concrete module to be enlarged with numpy module.
 """
 
 # Do not modify, this is to have a compatible namespace package

concrete/numpy/__init__.py

@@ -1,5 +1,5 @@
 """
-Declaration of `concrete.numpy` namespace.
+Export everything that users might need.
 """
 
 from .compilation import (

concrete/numpy/compilation/__init__.py

@@ -1,5 +1,5 @@
 """
-Declaration of `concrete.numpy.compilation` namespace.
+Glue the compilation process together.
 """
 
 from .artifacts import CompilationArtifacts

concrete/numpy/dtypes/__init__.py

@@ -1,5 +1,5 @@
 """
-Declaration of `concrete.numpy.dtypes` namespace.
+Define available data types and their semantics.
 """
 
 from .base import BaseDataType

concrete/numpy/extensions/__init__.py

@@ -1,5 +1,5 @@
 """
-Declaration of `concrete.numpy.extensions` namespace.
+Provide additional features that are not present in numpy.
 """
 
 from .convolution import conv2d

concrete/numpy/internal/__init__.py

@@ -1,3 +1,3 @@
 """
-Declaration of `concrete.numpy.internal` namespace.
+Export functions that are used internally by other modules for common things (e.g., assertions).
 """

concrete/numpy/mlir/__init__.py

@@ -1,5 +1,5 @@
 """
-Declaration of `concrete.numpy.mlir` namespace.
+Provide `computation graph` to `mlir` functionality.
 """
 
 from .graph_converter import GraphConverter

concrete/numpy/representation/__init__.py

@@ -1,5 +1,5 @@
 """
-Declaration of `concrete.numpy.representation` namespace.
+Define structures used to represent computation.
 """
 
 from .graph import Graph

concrete/numpy/tracing/__init__.py

@@ -1,5 +1,5 @@
 """
-Declaration of `concrete.numpy.tracing` namespace.
+Provide `function` to `computation graph` functionality.
 """
 
 from .tracer import Tracer

concrete/numpy/values/__init__.py

@@ -1,5 +1,5 @@
 """
-Declaration of `concrete.numpy.values` namespace.
+Define the available values and their semantics.
 """
 
 from .scalar import ClearScalar, EncryptedScalar