MAINT: LinkAhead rename

Summary

• in User Documentation (online, readmes, other doc folders)
• deprecate old imports
• add new ways to import
• search and replace in remaining files; change only if it has no functional implications
• Replace 'docs.indiscale.com` by new domain name. new issue

Test Environment

pipelines

Check List for the Author

Please, prepare your MR for a review. Be sure to write a summary and a focus and create gitlab comments for the reviewer. They should guide the reviewer through the changes, explain your changes and also point out open questions. For further good practices have a look at our review guidelines

• All automated tests pass
• Reference related issues
• Up-to-date CHANGELOG.md (or not necessary)
• Up-to-date JSON schema (or not necessary)
• Appropriate user and developer documentation (or not necessary)
  • How do I use the software? Assume "stupid" users.
  • How do I develop or debug the software? Assume novice developers.
• Annotations in code (Gitlab comments)
  • Intent of new code
  • Problems with old code
  • Why this implementation?

Check List for the Reviewer

• I understand the intent of this MR
• All automated tests pass
• Up-to-date CHANGELOG.md (or not necessary)
• Appropriate user and developer documentation (or not necessary)
• The test environment setup works and the intended behavior is reproducible in the test environment
• In-code documentation and comments are up-to-date.
• Check: Are there specifications? Are they satisfied?

For further good practices have a look at our review guidelines.

src/linkahead/exceptions.py

@@ -28,6 +28,8 @@ HTTP response codes) and for transaction errors (i.e. missing permissions,
 dependencies, non-passing consistency checks etc.).
 """
 
+from warnings import warn
+
 from lxml import etree
 
 
@@ -39,6 +41,13 @@ class LinkAheadException(Exception):
         self.msg = msg
 
 
+class CaosDBException(LinkAheadException):
+    def __init__(self, *args, **kwargs):
+        warn(("The name CaosDBException is deprecated. Please use LinkAheadException."),
+             DeprecationWarning)
+        super().__init__(*args, **kwargs)
+
+
 class ConfigurationError(LinkAheadException):
     """ConfigurationError.