Add Module.md files for different artifacts with module and package i…

…nfo (#4844)

* Add Module.md files for different artifacts with module and package info

This is what dokka uses to document packages and modules. Deleted the `package-info.kt` file as it doesn't do anything on its own, but can restore if it's still wanted

* Add Module.md for mockwebserver

* Only specify module if it exists

A bunch of samples don't have modules or readmes

* Remove package descriptors

build.gradle

@@ -144,6 +144,9 @@ subprojects { project ->
       prefix = "okhttp3.internal"
       suppress = true
     }
+    if (project.file('Module.md').exists()) {
+      includes = ['Module.md']
+    }
     externalDocumentationLink {
       url = new URL("https://square.github.io/okio/2.x/okio/jvm/index.html")
       packageListUrl = new URL("https://square.github.io/okio/2.x/okio/jvm/package-list")

mockwebserver/Module.md

@@ -0,0 +1,3 @@
+# Module mockwebserver
+
+A scriptable web server for testing HTTP clients.

okhttp-logging-interceptor/Module.md

@@ -0,0 +1,3 @@
+# Module okhttp-logging-interceptor
+
+An OkHttp interceptor which logs HTTP request and response data.

okhttp-sse/Module.md

@@ -0,0 +1,3 @@
+# Module okhttp-sse
+
+Support for server-sent events.

okhttp-tls/Module.md

@@ -0,0 +1,3 @@
+# Module okhttp-tls
+
+OkHttp Transport Layer Security (TLS) library.

okhttp/Module.md

@@ -0,0 +1,3 @@
+# Module okhttp
+
+An HTTP+HTTP/2 client for Android and Java applications.