DOC: update docs to reflect recent state of the package

[jsheunis]

Main TODOs:

• Remove outdated Attention blocks
• look into Update docs to label interaction with "published datasets" as "experimental" #241.
• Update python and cli reference pages
• Add not-supported clauses (ideally each with a short description of why/what/how/alternatives):
  • no unicode support
  • no supported for released dataverse datasets
  • no support for dataverse prior 5.13

Anything else?

[adswa]

The python and CLI API pages should already be up-to-date

[adswa]

I have a patch you could include (git apply <patch.txt>) in your PR (leaving it here to not interfere with your work)

diff --git a/_datalad_buildsupport/setup.py b/_datalad_buildsupport/setup.py
index 27e0821..b853b20 100644
--- a/_datalad_buildsupport/setup.py
+++ b/_datalad_buildsupport/setup.py
@@ -123,7 +123,7 @@ class BuildManPage(Command):
         dist = self.distribution
         #homepage = dist.get_url()
         #appname = self._parser.prog
-        appname = 'datalad'
+        appname = 'datalad-dataverse'
 
         cfg = read_configuration(
             opj(dirname(dirname(__file__)), 'setup.cfg'))['metadata']

would fix the wrong name in the footer:

[mih]

Thx much. I think we can close this