Discoverability issues

[ufukty]

Findings

The adapter package:

• Contains more than 300 symbols (tripling the net/http package)
• Contains unnecessarily exported fields as in "subclients" (eg. Payment) supposed to be initialized by client constructor internally although exports the dependency field Client.
• Lacks doc comments on most symbols.

The issue

The number of exported symbols makes it hard for first time readers to gain an overview. Lack of doc comments misses the opportunity of providing quick, inline information to user through code completion. Both makes harder to discover the feature set offered by the repository.