[Checkins] [zopefoundation/zope.interface] 771721: Documentation clarifications.

[Jason Madden]

  Branch: refs/heads/issue136-issue134
  Home:   https://github.com/zopefoundation/zope.interface
  Commit: 771721fccf4c88c798f850d7830af6448aca2232
      https://github.com/zopefoundation/zope.interface/commit/771721fccf4c88c798f850d7830af6448aca2232
  Author: Jason Madden <jamadden at gmail.com>
  Date:   2020-03-17 (Tue, 17 Mar 2020)

  Changed paths:
    M docs/adapter.rst
    M src/zope/interface/interfaces.py

  Log Message:
  -----------
  Documentation clarifications.

- docs/adapter.rst
  Subscriptions are returned from least to most specific, not the other way around; the docs were incorrect.

  Add additional examples, and use more verbose names in current examples, to clarify this. Fixes #136.
- interfaces.py
  names() and namesAndDescriptions() just return a collection, not a sequence. Fixes #134.