Update compatibility documentation

Author: claudioperez

source/about/features/compatibility.rst

@@ -41,3 +41,12 @@ To start an interactive Tcl interpreter using *xara*, run the following command
    python -m opensees
 
 
+Details 
+-------
+
+While *xara* aims to be compatible with OpenSeesPy and OpenSees Tcl, there are some differences and limitations.
+The following pages describe this in detail:
+
+- :ref:`Deprecations <about-features-deprecated>` Features of OpenSeesPy that are discouraged in *xara*, but still supported for backwards compatibility.
+- :ref:`Dropped Capabilities <about-features-dropped>` Features of OpenSeesPy that were *removed* in *xara*.
+- :ref:`Suspended Capabilities <about-features-suspended>` Features of OpenSeesPy that are temporarily disabled in *xara*, but will be added in the future.

source/about/features/dropped.rst

@@ -1,3 +1,5 @@
+.. _about-features-dropped:
+
 Dropped Capabilities
 ^^^^^^^^^^^^^^^^^^^^
 

source/about/features/index.rst

@@ -1,14 +1,17 @@
 Features
 ^^^^^^^^
 
-Xara offers several advanced features that make it a powerful tool for nonlinear finite element analysis:
+A strong feature of xara is its backwards compatibility with OpenSeesPy and Tcl scripts. 
+This compatibility is described in `Compatibility <CompatibilityLayer>`_.
+..
+   Xara offers several advanced features that make it a powerful tool for nonlinear finite element analysis:
+   - **Mixed Formulations**: It supports mixed formulations for beams and solids, enabling accurate modeling of complex structural systems.
+   - **Extensive Material Models**: With over 200 material models, Xara provides flexibility for simulating various materials and their nonlinear behaviors.
+   - **Performance Optimization**: Built on the OpenSeesRT framework, Xara delivers substantial performance improvements over traditional interpreters.
+   - **Continuation Algorithms**: These algorithms are designed to solve highly nonlinear problems efficiently, making Xara suitable for challenging engineering scenarios.
+   - **Stateless Modeling**: Xara introduces a `Model` class for true stateless modeling, allowing users to work without relying on a single global program state.
+   - `Compatibility Layer <CompatibilityLayer>`: Although *xara* in includes a completely rewritten interpreter architecture, compatibility layers allow legacy OpenSeesPy and Tcl scripts to run with minimal modifications.
 
-- **Mixed Formulations**: It supports mixed formulations for beams and solids, enabling accurate modeling of complex structural systems.
-- **Extensive Material Models**: With over 200 material models, Xara provides flexibility for simulating various materials and their nonlinear behaviors.
-- **Performance Optimization**: Built on the OpenSeesRT framework, Xara delivers substantial performance improvements over traditional interpreters.
-- **Continuation Algorithms**: These algorithms are designed to solve highly nonlinear problems efficiently, making Xara suitable for challenging engineering scenarios.
-- **Stateless Modeling**: Xara introduces a `Model` class for true stateless modeling, allowing users to work without relying on a single global program state.
-- `Compatibility Layer <CompatibilityLayer>`: Although *xara* in includes a completely rewritten interpreter architecture, compatibility layers allow legacy OpenSeesPy and Tcl scripts to run with minimal modifications.
 
 .. toctree::
    :hidden:

source/about/features/suspended.rst

@@ -1,3 +1,5 @@
+.. _about-features-suspended:
+
 Suspended
 ^^^^^^^^^