Update opentracing docs to reference the configuration manual rather than the configuation file. (#13076)

Add a config option which allows enabling opentracing by user id, eg for
debugging requests made by a test user.

Converting some of the rst documentation to markdown.  Attempted to
preserve whitespace and line breaks to minimize cosmetic change.