Re: [PATCHv2] submodules: overhaul documentation

quoted

+ * the `.gitmodules` file inside the superproject. A project usually
+   includes this file to suggest defaults for the upstream collection
+   of repositories.

I dislike this last point.  Realistically we don't want this right?  So
perhaps we shouldn't include it?

Well, it describes the current situation accurately. In a resend
I'll de-emphasize it.