ask for better documentation.

diff --git a/doc/todo/documentation__58___improve_on_special_remotes.mdwn b/doc/todo/documentation__58___improve_on_special_remotes.mdwn
new file mode 100644 (file)
index 0000000..ed44cae
--- /dev/null
+++ b/doc/todo/documentation__58___improve_on_special_remotes.mdwn
@@ -0,0 +1,9 @@
+Even though there is a [special_remotes](https://git-annex.branchable.com/special_remotes/) page, description there is quite superficial and does not provide a good overview of various aspects on special remotes 
+
+- life cycle, e.g. how they relate to Git remotes -- that they become listed among `git remote`s whenever enabled, that git remotes get the corresponding `annex-uuid` assigned when "sensed" or get annex-ignore, how to "disable" an enabled remote (just `git remote remove`)
+- clearly list commands to operate on the special remotes (initremote, enableremote) or interrogate them (e.g. how to figure out if there is already a special remote with a target uuid but may be not enabled yet, etc)
+
+Without such a documentation it is hard to "on board" new git-annex users and developers.
+
+[[!meta author=yoh]]
+[[!tag projects/dandi]]