-*Issues still to be tackled in this repo:*
-
-* Let fetch run recursively on submodules (in progress)
-* Showing that a submodule has a HEAD not on any branch in "git status" (in progress)
-* Check before a push in the superproject that all submodules HEADs are pushed
-* gitk: Add popup menu for submodules to see the detailed history of changes
-* Let checkout, checkout-index, read-tree & reset work recursively on submodules (in progress)
-* Let stash work recursively on submodules
+*Issues currently being worked on*
+
+* [[Recursive submodule checkout]]: teach all work tree manipulating commands to update the submodule work trees according to the commit recorded in the superproject.
+* Teach @git fetch@ to also fetch commits for submodule not currently in the work tree into .git/modules/<name>
+
+*Issues still to be tackled*
+
+* Add functionality to move the .git directory of a submodule into the .git/modules directory of the superproject (either by adding a new @git submodule@ command or by providing a script in contrib/)
+* Add a git-config aware merge driver and make it the default for .gitmodules
+* Attempt a 3-way merge when @git mv@, @git rm@ or @git submodule add@ want to change a .gitmodules file which has unstaged changes
+* Add configuration options (global, per repo and per submodule) to set the default of @git push --recurse-submodules@
+* Add a tutorial explaining the different use cases and the configuration settings which suit them.
+* Add an option to @git submodule add@ to move the .git directory of a local repository to be added as submodule into the .git/modules directory of the superproject
+* Teach @grep@ the @--recursive@ option
+* Add means to specify which submodules shall be populated on clone (which I'd like to implement by teaching @git fetch@ to create submodule repos in .git/modules, recursive checkout will then do the rest)
+* Showing that a submodule has a HEAD not on any branch in the @git status@ of the superproject
+* @gitk@: Add popup menu for submodules to see the detailed history of changes
+* Teach @git prune@ the @--recurse-submodules@ option (and maybe honour the same default and options @git fetch@ uses)