update log bumping

Author: tomvanmele

.bumpversion.cfg

@@ -15,3 +15,7 @@ replace = release = '{new_version}'
 [bumpversion:file:src/compas_fea/__init__.py]
 search = __version__ = '{current_version}'
 replace = __version__ = '{new_version}'
+
+[bumpversion:file:CHANGELOG.md]
+search = Unreleased
+replace = [{new_version}] {now:%Y-%m-%d}

CHANGELOG.md

@@ -9,17 +9,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
-### Changed
-
-### Removed
-
-
-## Unreleased
-
-### Added
-
-* Added support for `compas` v1.0
-* Include changelog for releases
+* Added support for `compas` v1.0.
+* Include changelog for releases.
+* Added changelog to bump version.
 
 ### Changed
 

docs/gettingstarted/installation.rst

@@ -2,56 +2,69 @@
 Installation
 ********************************************************************************
 
-.. _Anaconda: https://www.continuum.io/
-.. _EPD: https://www.enthought.com/products/epd/
-
-
-To use ``compas_fea`` you need to install COMPAS,
-and have at least on of the supported analysis backends available on your system.
-Currently, ``compas_fea`` supports Abaqus, ANSYS, and OpenSEES to various degrees.
-See :ref:`fea` for more detailed information.
+.. note::
 
-By installing COMPAS all required Python packages for ``compas_fea`` will be installed as well.
-To install COMPAS, see the `Getting Started <https://compas-dev.github.io/main/gettingstarted.html>`_ instructions in the COMPAS docs.
+    Old versions of :mod:`compas_fea` were installed by adding the location of a
+    local source folder directly to the ``PYTHONPATH``.
+    If you still have such a legacy install on your system, we highly recommend
+    that you remove all traces of it, which means to remove :mod:`compas`,
+    :mod:`compas_fea`, or any other COMPAS packages from your ``PYTHONPATH``,
+    because it will interfere with the proper functioning of more modern, flexible
+    and robust installation procedures adopted by the COMPAS ecosystem.
 
-``compas_fea`` itself can be installed using ``pip`` from a local source repo, or directly from GitHub.
+    This also applies to old procedures for installing COMPAS packages for Rhino.
+    If you still have COMPAS packages registered directly in the ``Modules Search Path`` in Rhino,
+    please remove them.
 
 
-.. note::
+Requirements
+============
 
-    Make sure to install ``compas_fea`` in the same environment as COMPAS!
+To use :mod:`compas_fea` you need to install COMPAS,
+and have at least on of the supported analysis backends available on your system.
+Currently, :mod:`compas_fea` supports Abaqus, ANSYS, and OpenSEES to various degrees.
+See :ref:`fea` for more detailed information.
 
+To install COMPAS, see the `Getting Started <https://compas-dev.github.io/main/gettingstarted.html>`_
+instructions in the COMPAS docs.
 
-From Local Source
-=================
 
-To install from a local source repo, clone the repo onto your computer using your Favourite Git client,
-or using the command line.
+Install :mod:`compas_fea`
+=========================
 
-Then navigate to the root of the ``compas_fea`` repo and install using pip:
+As with all other COMPAS packages, we recommend to install :mod:`compas_fea` in a ``conda`` environment.
 
 .. code-block:: bash
 
-    cd compas_fea
-    pip install -e .
+    conda create -n fea -c conda-forge python=3.9 compas --yes
+    conda activate fea
+    pip install compas_fea
 
 
-From GitHub
-===========
+Working in Rhino
+================
 
-To install directly from the GitHub repo, just do
+If you wish to use :mod:`compas_fea` in Rhino, you have to add it to the installed Rhino COMPAS packages.
 
 .. code-block:: bash
 
-    $ pip install git+https://github.com/compas-dev/compas_fea.git#egg=compas_fea
+    conda activate fea
+    python -m compas_rhino.install -v 7.0
+    python -m compas_rhino.install -v 7.0 -p compas_fea
+
+For more information about using COMPAS in Rhino, see the COMPAS docs:
+https://compas.dev/compas/dev/gettingstarted/rhino.html
 
 
-Verify
-======
+Working in Blender
+==================
 
-To check the installation, open an interactive Python prompt and import the package.
+To use :mod:`compas_fea` in Blender, you simply have to register the environment with Blender.
+
+.. code-block:: bash
 
-.. code-block:: Python
+    conda activate fea
+    python -m compas_blender.install -v 2.93
 
-    >>> import compas
-    >>> import compas_fea
+For more information about using COMPAS in Blender, see the COMPAS docs:
+https://compas.dev/compas/dev/gettingstarted/blender.html