ansys · akaszynski · Dec 30, 2021 · Dec 30, 2021 · MaxJPRey · Dec 30, 2021
diff --git a/doc/source/abstraction/index.rst b/doc/source/abstraction/index.rst
diff --git a/...abstraction/app_interface_abstraction.rst → .../guidelines/app_interface_abstraction.rst b/...abstraction/app_interface_abstraction.rst → .../guidelines/app_interface_abstraction.rst
diff --git a/...tion/data_transfer_and_representation.rst → ...ines/data_transfer_and_representation.rst b/...tion/data_transfer_and_representation.rst → ...ines/data_transfer_and_representation.rst
diff --git a/doc/source/overview/dev_practices.rst → doc/source/guidelines/dev_practices.rst b/doc/source/overview/dev_practices.rst → doc/source/guidelines/dev_practices.rst
diff --git a/doc/source/guidelines/index.rst b/doc/source/guidelines/index.rst
@@ -0,0 +1,20 @@
+Guidelines
+#############################
+The purpose of this section is to highligh some common practices that
+can be applied to the entire PyAnsys project in order to remain consistent.
+
+One of the main objectives of PyAnsys libraries is to wrap (encapsulate) 
+data and methods within units of execution while hiding data or parameters 
+in protected variables.
+
+Those guidelines demonstrate how applications and complex services expose
+functionalities such as logging, data transfer...
+
+.. toctree::
+   :hidden:
+   :maxdepth: 3
+
+   dev_practices
+   app_interface_abstraction
+   service_abstraction
+   data_transfer_and_representation
diff --git a/...ource/abstraction/service_abstraction.rst → ...source/guidelines/service_abstraction.rst b/...ource/abstraction/service_abstraction.rst → ...source/guidelines/service_abstraction.rst
diff --git a/doc/source/index.rst b/doc/source/index.rst
@@ -8,7 +8,7 @@
    :maxdepth: 3
 
    overview/index
+   guidelines/index
    library_description/index
-   abstraction/index
    coding_style/index
    documentation_style/index
diff --git a/doc/source/overview/index.rst b/doc/source/overview/index.rst
@@ -66,7 +66,6 @@ PROTO files, create coverage reports, and report on system coverage:
    basic
    administration
    contributing
-   dev_practices
 
 .. _PyAEDT: https://github.com/pyansys/PyAEDT
 .. _PyMAPDL: https://github.com/pyansys/pymapdl